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Preface 


This publication contains a summary of ACF/VTAM Version 
2 reference information which is presented under four major 
headings: 


e Part 1. Operation 

e Part 2. Installation 
e Part 3. Programming 
@ 


Part 4. SNA Reference Data 


Refer to the Contents for a list of the specific topics included 
in each part of the manual. 


Supplemental publications include but are not limited to: 


e General Information: 
ACF/VTAM General Information, GC27-0608 


e Planning and Installing ACF/VTAM: 
ACF/VTAM Planning and Installation Reference, 
$C27-0610 


@ Writing Application Programs: 
ACF/VTAM Programming, SC27-0611 


e@ Operating ACF/VTAM: 
ACF/VTAM Operation, SC27-0612 


@ Messages: 
ACF/VTAM Messages and Codes, SC27-0614 


e Diagnosis: 
ACF/VTAM Diagnosis Guide, SC27-0630 (VSE), 
$C27-0615 (OS/VS) 
ACF/VTAM Diagnosis Reference, LY38-3058 (VSE), 
LY38-3053 (OS/VS) 
ACF/VTAM Data Areas, LY38-3059 (VSE), LY38-3054 
(OS/VS) 
ACF/VTAM Logic: Encrypt/Decrypt Feature, 
LY38-3055 


e Systems Network Architecture Reference Summary, 
GA27-3136 
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Summary of Amendments (November 15, 1982) to 
$X27-0027-0 by Technical Newsletter SN31-1339 


New Program Functions 


ACF/VTAM supports the communication adapter feature of 
the IBM 4321 and 4331 Processors. This feature allows 
resources to be link-attached to the host processor without 
using a communication controller. 


It also supports ACF/NCP Version 2 for the IBM 3705 
Communications Controller. This includes support for a new 
NCP trace, the generalized path information unit trace 
(GPT). GPT records the flow of path information units to or 
from an NCP and its subordinate physical and logical units. 


New Documentation 


In Part 1, the MODIFY, START, and VARY commands 
contain support for the communication adapter and GPT. 
The internal trace record summary includes new communica- 
tion adapter entries for error recovery procedures, interrupts, 
and start |/O. 


In Part 2, definition statements have been added for re- 
sources attached through a communication adapter. 


Changed Documentation 


In Part 2, the OPT and SUPP operands have been added to 
the USSMSG macro instruction for terminal operator 
messages. Also, the description of how ACF/VTAM 
processes the IBMTEST command has been corrected. 


In Part 4, request reject sense codes for VSE have been 
added. 


Minor editorial changes have also been made. 


PART 1. OPERATION 
ACF/VTAM Operator Commands 


DISPLAY Commands! 





DISPLAY NET,APPLS[,ACT|EVERY|INACT] 
DISPLAY NET,BFRUSE 

DISPLAY NET,CDRMS? [,ACTIEVERYIINACT] 
DISPLAY NET,CDRSCS? [,ACTIEVERY|INACT] 
DISPLAY NET,CLSTRS[,ACTIEVERY|INACT] 
DISPLAY NET,ID=name? LACTIEVERY|INACT|NONE] 
DISPLAY NET,LINES[,ACTIEVERY|INACT] 

DISPLAY NET,MAJNODES 


DISPLAY NET,NCPSTOR,|ID=ncpname,ADDR=address 
[,LENGTH=n/32] 


—e 


DISPLAY NET,PATHS,|ID=switched physical unit name 

DISPLAY NET,PATHTAB[,ADJSUB=subarea| DESTSUB= 
subarea | 

DISPLAY NET,PENDING 

DISPLAY NET,ROUTE,DESTSUB=subarea 


[,COSNAME=name|ER=n|ER=ALL|VR=n] 
[TEST=YES|NO] 








DISPLAY NET,STATIONS[,ACTIEVERYIINACT] * 
[,1D=node name] 


DISPLAY NET,TERMS[,ACTIEVERY|INACT] 
DISPLAY NET,U,° 1D=tso userid 





1 The following abbreviations may be used: 


ACT=A INACT = | 
DISPLAY =D NONE = N 
EVERY =E PATHS =P 


2 Applies only to multiple-domain networks. 

3 Does not apply to application program major nodes. 

4 Also can be specified as SCOPE=ACTISCOPE=ALL| 
SCOPE=INACT. 

5 Applies only to MVS with TSO/VTAM. 








EXEC Command! 
Enter EXEC PROC=procname 


and, if prompted, one or more of these start 
options: 


CDRSCTI=n|480 

COLDIWARM 

CONFIG=xx|00|name 

HOSTSA=n/1 

lOINT=n|180 

ITLIM=n|0 

LIST=xx|00 

MAXAPPL=n110 

MAXSUBA=n/15 

MSGMOD=YESI|NO 

NODELST=name 

SONLIM=([mi60] [,n/30] ) 

SSCPID=n = 

SUPP=[NOSUP|INFO|WARNINORMISER] 

{NOSNSTAD en MES nice! 

NOTNSTAT 7 

TRACE|NOTRACE,T YPE=BUF, ID=nodename[,EVER Y|E? ] 

TRACE|NOTRACE,T YPE=I0,ID=nodename[,EVER YE? ] 

TRACE|NOTRACE,TYPE=LINE,ID=linename 

TRACE|NOTRACE,TYPE=SMS,|ID=VTAMBUF 

TRACE,T YPE=VTAM[,MODE=INTIEXT] 
[,OPTIONS=(option)? ] 
(API,MSG,PIU)|ALL] 
[,SIZE=nnni2] 
NOTRACE,TYPE=VTAM 7 

USSTAB=name 

VF BUF=vbsz 

VPBUF=vbsz 

VTAMEAS=n|404 

poolname=(baseno,bufsize,slowpt,xpanno,xpanpt) 





1 Applies to VSE only. 

OS/VS users should use the START command. 
2 EVERY or E may be used. 
3 Options may be one of the following: 

API, ClO, LOCK, MSG, PIU, PSS, SMS, SSCP. 


HALT Commands? 


HALT NET[,CDLINK?=ACT|INACT] 


HALT NET,CANCEL?® 


HALT NET,QUICK[,CDLINK? =ACT|INACT] 





1 HALT or Z may be used. 
2 Applies only to multiple-domain networks. 


3 Applies to OS/VS only; causes an abend of ACF/VTAM 
with a system completion code of hex OAQ. 





MODIFY Commands? 


MODIFY procname,? CDRM?=(new cdrm[,old cdrm] ) 
{,1D=cdrsc major node namel|cdrsc 
minor node name] 


MODIFY procname,? CSALIMIT*=n|(n[,F] ) 


MODIFY procname,? DUMP,ID=ncp name or link 
station name 
[, DUMPDS=name] 
[, DUMPSTAG=link station name] 
[, OPTION’ =DYNA|STATIC] 
[ ,RMPO=YES|NO] 


MODIFY procname,? ENCR®= {OPTIREQD } ,ID=logical 
unit name 


MODIFY procname,? IMR,ID=link station or physical 
unit name 
[,OPTIONS =ACTIINACT] 
[, RECLIM=n|10] 


MODIFY procname,”? IOPD[,IOINT=n] 


MODIFY procname,? LL2,1D=name’ [,OPTION=CANCEL| 
CONT] 
[,.NTRANS=10|m] 
[,DATA=data] [,NFRAMES=n|1] 


1 MODIFY or F may be used. 
2In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 
The procname operand is the name of the cataloged 
procedure by which ACF/VTAM was started. 
3 Applies only to multiple-domain networks. 
* Applies to MVS only. 
> OPTION or OPT may be used. 
© Applies to Encrypt/Decrypt Feature only. 
71D=name may be the PU name, or the link station 
name for the NCP or for the adjacent host. 
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MODIFY Commands! (Continued) 
MODIFY procname,? MSGMOD= { YESINO } 


MODIFY procname,* NEGPOLL=number of responses,|D= 
line name 


MODIFY procname,? NOTNSTAT 


MODIFY procname,? NOTRACE,TYPE={BUF|IO},ID=node 
name[,SCOPE=ALLIONLY? ] 


MODIFY procname,? NOTRACE, TYPE= {LINEIGPT* ISMS| 
TGITSO® } ,|D=name 


MODIFY procname,? NOTRACE,TYPE=VTAM 
{[, OPTION=ALLIoption| 
(option[,. . ..option] *)|END] 


MODIFY procname,? POLL=n,ID=line name 
MODIFY procname,? SESSION=n,!D=line name 


MODIFY procname,? SUBTASK,’” |D=namelTPRINT, 
FUNCTION={ ATTACHIDETACH| 
MsG } 

and if prompted, one or more of these trace print options: 

CANCEL 

PRINT 

BUF=ALL 

BUF=name[, .. . ,name] 

CLEAR=YES|NO 

INTERVAL=beginning time? | (end,time)| (beginning time, 

end time) 


1 MODIFY or F may be used. 

21In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 

3SCOPE=ALLIONLY can also be specified as EVERY or E. 

4 1f an NCP name is specified for the ID operand, SCOPE= 
ALLIONLY may also be specified. For all other ID= 
values, the command is processed as if SCOPE=ALL were 
specified. 

5 Applies to MVS only. 

6 Options may be one or more of the following: 
API, ClO, LOCK, MSG, PIU, PSS, SMS, SSCP. 

7 Applies to VSE only. 

8 Specify the time as yy.ddd/hh:mm:ss, yy.ddd, or 
hh:mm:ss. 





MODIFY Commands! (Continued) 


IO=ALL 

1O=name[,... ,name] 
LINE=ALL 

LINE=name 

TNST=ALL 
TNST=name[, ... ,name] 
VIT 


MODIFY procname,? {NOSUPIINFOIWARNINORM| 
SER 


MODIFY procname,? TEST 


MODIFY procname,’? TNSTAT[,CNSL=YES|NO® ] 
[, TIME=n] 


MODIFY procname,? TRACE,TYPE= {BUFIIO } ,ID=name* 
[,SCOPE=ALLIONLY] ° 


1 MODIFY or F may be used. 
2In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 
*>CNSL=YESINO can also be specified as CNSLINOCNSL. 
*1D=name specifies the name of the resource for which 
tracing is to be done. This operand does not apply for 
TYPE=VTAM. 


Names of various types of resources can be specified, de- 
pending on the value of the TYPE operand. 


For TYPE=BUF or TYPE=10 

Any of the following names can be specified with the 
SCOPE operand to trace message activity with the named 
resource, if applicable, and all of the resource’s subordinate 
nodes: 


@ The name of an NCP major node. 
e@ The name of a channel-attachment major node (only 
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MODIFY Commands! (Continued) 





TYPE=I0, SCOPE=ALL can be specified). 


The name of a line attached to a communication adapter 
(only TYPE=IO, SCOPE=ONLY can be specified) 


The name of a physical unit (including switched and 
channel-attached SNA physical units) 


e The name of a logical unit 
Any of the following names can be specified to trace 
message activity with the named resource: 


ISTPUS (for a trace of RUs between this host’s PU 
type 5 and another PU type 4 or 5; these RUs include 
ER-OP, ER-IOP, ER-ACT, or ER-TEST) 

ISTIRN (for a trace of all PIUs received from a channel- 
attached PU type 4 or 5, passing through this host, 
and being sent to another channel-attached PU type 
4 or 5) 

VTAM (for a trace of all SSCP sessions) 

The name of an NCP 

The name of a physical unit (including switched and 
channel-attached SNA physical units) 

The name of a logical unit (including application 
programs) 

The name of a channel-attached non-SNA terminal 
The name of a CDRM (only in a multiple-domain 
network) 

The name of a CDRSC (only in a multiple-domain 
network) 


5 SCOPE=ALLIONLY can be specified as EVERY (E). 





MODIFY Commands! (Continued) 


MODIFY procname,? TRACE,TYPE= 
{ LINEIGPT?|SMS/TG|TSO*} 
,|D=name* 


1 MODIFY or F may be used. 

2In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 

31f an NCP name is specified for the 1D operand, SCOPE= 
ALLIONLY may also be specified. For all other |D= 
values, the command is processed as if SCOPE=ALL were 
specified. 

4Applies to MVS only. 


51D=name specifies the name of the resource for which 
traci..g is to be done. This operand does not apply for 
TYPE=VTAM. 


Names of various types of resources can be specified, de- 
pending on the value of the TYPE operand. 


For TYPE=LINE 

The ID operand specifies the name of the line for which 
tracing is to be done. The ID operand cannot specify a line 
attached to a communication adapter. 


For TYPE=GPT 
The ID operand specifies the name of either the NCP or the 
NCP resource for which tracing is to be done. 


For TYPE=SMS 
ID=VTAMBUF must be specified for an SMS trace. 


For TYPE=TG 

The ID operand specifies the name of a line currently 
within the transmission group to be traced. All the lines 
in the transmission group are traced as if they were a 
single logical line. The 1D operand cannot specify a line 
attached to a communication adapter. 


For TYPE=TSO 


The 1D operand specifies the TSO user ID for which tracing 
is to be done. 





MODIFY Commands? (Continued) 


‘eas «= MODIFY procname,? TRACE,TYPE=VTAM 
[ MODE=INTIEXT] 
[ OPTION=option| 
(option[, .. . ,option®] )|ALL] 
[,S1ZE=nnn] 


1 MODIFY or F may be used. 
2In VSE, use NET. 
in OS/VS1, use procname.Pnn. 
ew’ In MVS, use procname. 


? Options may be one or more of the following: API, CIO, 
LOCK, MSG, PIU, PSS, SMS, SSCP. 


8.1 





C ¢€¢ ¢ C ¢€¢ ¢ 


MODIFY TRACE Types 
ee 
=ALL LINE TG | TSO | VTAM 


GPT, 
SCOPE 
=ALL 


BUF, 
SCOPE 
=ALL 


Application Program Major Node 
Application Program Minor Node 
Local SNA Major Node 
Local SNA Physical Unit 
Local SNA Logical Unit 
Local Non-SNA Major Node 
Local Non-SNA Minor Node 
NCP 
Nonswitched Line 


Switched Line 


© Link Station 


OL 


Physical Unit 
Logical Unit 
Switched Major Node 
Switched Physical Unit 
Switched Logical Unit 
Path Definition Set 
CDRM Major Node 
CDRM Minor Node 
CDRSC Major Node 
CDRSC Minor Node 





MODIFY TRACE Types (Continued) 


BUF, GPT, 
SCOPE SCOPE esckE 
=ALL GPT | =ALL =ALL LINE TG | TSO | VTAM 


ome CRC RECOECOL 


baad 
a 
= 
- 
pal 
aa 
od 
i 
aod 
i 

C 





Channel-Attachment Major Node 
Channel Link 
Channel Link Station 
Nonswitched Line 
Switched Line 
SDLC Link Station 
Physical Unit 
Logical Unit 

ISTPUS 

ISTIRN 

VTAM 

_ VTAMBUF 


MODIFY TRACE Types (Continued) 


BY BR eo no 

SCOPE SCOPE SCOPE 

=ALL | GPT | =ALL =ALL LINE TG} TSO} VTAM 
| | | of} te | ft ft fp 
nee (a (2 ae ( ( 
a ean CR (a eee (A Tc 
a Ny ee a (a 
de ee Od 
SEE (Re ANAS SA NAN OS MN EH 
iS a eH ( 
pepe 
Ace a a FE eee a A 
A OG OO 
peje | Tepe 
ae a (a a a ee (A eee 








START Command! 


Enter START? ( procname } [,, ,(options,. . .)] 
procname.Pnn?® 


where the start options may be one or more of the following: 

CDRSCTI=n|480 

COLDIWARM 

CONFIG=xx/|Q0jname 

CSALIMIT=n|0* 

DLRTCB=n\8° 

DLRTCB=n|32* 

HOSTSA=n|1 

lOINT=n|180 

ITLIM=nj0 

LIST=xx|00 

MAXAPPL=n|10 

MAXSUBA=n/15 

MSGMOD=YES|NO 

NODELST=name 

SONLIM=([m{60] [,n|30] ) 

SSCPID=n 

SUPP=[NOSUP|INFO|WARN|NORMISER] 
TNSTAT[,CNSLINOCNSL] [,TIME=ni60] 
NOTNSTAT 

TRACE|NOTRACE,T YPE=BUF,ID=nodename[,EVERY *] 

TRACE|NOTRACE,TYPE=IO,I D=nodename [EVERY ‘® ] 

TRACE|NOTRACE,TYPE=LINE,|ID=linename 

TRACE|NOTRACE,TYPE=SMS,|D=VTAMBUF 


TRACE, TYPE=VTAM[,MODE=INTIEXT] 
[,OPTIONS=(options)| 
(API,MSG, PIUS)|ALL] 
[,SIZE=nnn/2] 
NOTRACE,TYPE=VTAM 


1 Applies to OS/VS only. 
VSE users should use the EXEC command. 

2START or S. 

3 Applies to OS/VS1 only. 

4 Applies to OS/VS2 (MVS) only. 

SEVERY or E. 

6 Options may be one or more of the following: 
API, CIO, LOCK, MSG, PIU, PSS, SMS, SSCP. 
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START Command! (Continued) 


USSTAB=name 
VTAMEAS=n1404 
poolname=(baseno,bufsize,slowpt,F,xpanno,xpanpt) 


1 Applies to OS/VS only. 


VSE users should use the EXEC command. 
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VARY Commands? 


VARY NET,ACO,|ID=name 
,ACT[,LOGMODE=logon mode name] 


[,LOGON=primary LU name or 
cdrsc name 


[,SCOPE=ALL|COMPIONLY]|U] 





VARY NET,ACT,ID=name 
[, ANS? =ON|OFF] 
[, DUMPSTA=name] 
[, LOAD=YES|NO|U] 
[, LOADSTA=name] 
[,LOGMODE=logon mode name] 
[,LOGON=primary LU name or ae 
cdrsc name? ] rd 
[,RNAME=namel](namet1,...,name13) ] 
[, SCOPE* =ALLICOMPIONLYIU] 
[, U=channel device name] 
[,WARN* ] 








1VARY or V. 

2 Applicable when using SDLC only. 

3 Applies only to multiple-domain networks; a CDRSC name 
must be an application program in another domain. 

4 Note that WARM and SCOPE cannot be specified on the 
same command. If both are specified, the command fails. 
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VARY Commands' (Continued) 


The following table indicates each resource type for 
which the command is valid and which operands can be 
used on the command. A bullet (¢) indicates that the 
operand applies to that resource and an S indicates that 
the operand can be specified for sifting to subordinate 
resources. An M indicates that the operand applies to 
that resource only in certain migration cases. 


V NET.ACT, 





Application Program Major Node ee ee 
Application Program Minor Node ae ee ee ee es aE 


Local SNA Major Node ol ee ee ee i 
Local SNA Physical Unit Fae CC 
Local SNA Logical Unit a ae ee a i 


Local Non-SNA Major Node ae Ee 
LocalNon-SNA MinorNode || | | fete] | | UL Ce | 


ie releleleis{slelele| le 
Nonswitched Line Lf pe PS is pt fe] 
Switched Line | {| je} | | | | | [ele 
Link Station a ceuee ate TM LS NeSet ah oat Si aioe 
Physical Unit ene eee eee 
Logical Unit (a Ss ae ee 
Switched Major Node rel tel tstst 11 [Tel 
Switched Physical Unit tes Oe Sees ld cee 
Switched Logical Unit | | [| [ fete} {| [ | Je] 
Path Definition Set me eee eee eee 
CDRM Major Node? Ol pO |= te Ne eS ae 
CDRM Minor Node? fizcall 2 fee ies Nae te UNS St cece (te ee 
CDRSC Major Node? Se ee ee ee ee 
CDRSC Minor Node? i a ee ee 
Channel Attachment Major Node fe{ jel {| | | | [ | fel 
Channel Link is he ae a a a ee ee 
Channel Link Station | {| jel | | | fT [| [| fel 
Nonswitched Line | jefe; {s}s{ | | |] fe) 
Switched Line | jefe; {| | [| [ | Jefe 
SDLC Link Station Rm nh hm mmr 
Physical Unit es ee ee ee 
Logical Unit | {| [| [| Jefe} {| |}| | |e] 
VARY NET,ANS?= {ON|OFF} ,ID =line name 
[, ACT] 
™VARY or V. 


Applies only to multiple-domain networks; a CDRSC name 
must be an application program in another domain. 
3Applicable when using SDLC dial only. 
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VARY Commands’ (Continued) 





VARY NET,DRDS,ID =drname 
VARY NET, INACT?2,ID =name 
[, CDLINK = ACT|INACT?] 
[,FINAL] 
[,||F*|R®] 
{,R MPO] 
The following table indicates each resource type for vest” 


which the command is valid and which operands can be 
used on the command. A bullet (¢) indicates that the 
operand applies to that resource. An |, F, or R in the table 
indicates what value is substituted if an F or R operand is 
specified for a resource to which it does not apply. 





Vv | NETACT, ACT, 


Mr 


Application Program Major Node | frFfefe] | [el] 
Application Program Minor Node | j[ejefej; | fe] 


Local SNA Major Node fF fai fTtftel f fe] 

Local SNA Physical Unit | f{[e{fe[{[el{e|] |e] 

Local SNA Logical Unit | j[rfefe; | fe 

Local Non-SNA Major Node PF ti ftifte] [| fe] 

Local Non-SNA Minor Node | [rf{fefef | fe, 

NCP (SOs) Sl) ees) Lee 

Nonswitched Line | f[efef{fe|; | |e] 

Switched Line rar ae aes 

Link Station aye Oe = 2 pe = 
Physical Unit rea eae — 
Logical Unit Pte feet Te ew 
Switched Major Node | of i fat fet | fe. 

Switched Physical Unit | f[ejr{e{fe|] |e, 

Switched Logical Unit | f[rfjfefef | fe] 

Path Definition Set as ee a ae a ee 

CDRM Major Node? Miche eee | 
CDRM Minor Node* | je fef}ef | je ee 
CDRSC Major Node PT Tetetel Tre ww 
CDRSC Minor Node? NEE Nee Ore i 108] 

Channel Attachment Major Node | fi fife] | je] 

Channel Link | [eteje|}] | {el 

Channel Link Station | fefeltef | je, 

Nonswitched Line | [rfefef | je eS 
Switched Line misters eas 
SDLC Link Station | jefe;le|] | je 

Physical Unit | fefetete|] f{e. 

Logical Unit RAP rae ES 
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VARY Commands? (Continued) 


i VARY NET,INOP ,1D=line name[,END] 
,1D=physical unit name 


VARY NET,LOGON=primary LU name or 
cdrsc name °,ID=name 
[,LOGMODE=logon mode name] 


VARY NET,PATH=USE|NOUSE 
se ieee major node | 
,P1D=n,!D=physical unit name 


. , VARY NET,REL,ID=name 
[,.CDLINK=ACTIINACT? ] 
[1] 


VARY NET,TERM, 


,LU1=LU name[,LU2=LU name] 
,“LU2=LU name[,LU1=LU name] 
,PLU=primary LU name[,SLU=secondary 
LU name] 
,o|D=session identifier 
»o_LU=secondary LU name[,PLU=primary 
LU name] 
[L.NOTIFY=YES|NO] 
[, SCOPE=ACTIALLIQ] 
a [, TYPE=COND|IUNCONDIFORCE] 


ee 1VARY or V may be used. 

w *Warning: TSO/VTAM users should never use this 
command to deactivate a TSO user memory while 
TSO/VTAM is operating. 

3Applies only to multiple-domain network. 
; 4F or FORCE may be used. 
ey’ 5R or REACT may be used. 
© Applies only to multiple-domain networks;a CDRSC name 
must be an application program in another domain. 
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Resource Status Codes 


ACF/VTAM provides detailed information on the status of 
a resource. This status is defined by a state code and is 
generally contained in a 10-character format: statexxxxx. 


The following text describes the possible state codes. They 
are listed in numeric order. 


Status-modifier (xxxxx) information is included after the 
list of status codes. 


Note: For resource status codes of sessions involving appli- 
cation programs and cross-domain resources, see message 
IST6351 or 5G351. 


The classification of states into the following major cate- 
gories may aid in deciding if a problem exists. 


State Code 


Category 


Final 


Short Transient 


Long Transient 
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Meaning 


ACF/VTAM has no further processing to 
do for the node. 


The node is awaiting completion of an 
operation (such as I/O) that will take a 
relatively short time to complete. If 
the node remains in this state for a long 
time, there is probably a hardware or 
software error. 


The node is awaiting completion of an 
operation that will take a relatively long 
time to complete. If the node remains in 
this state for an unreasonable length of 
time, there is probably a hardware or 
software error. 








Resource Status Codes 


Category Meaning 


Suspended This node is awaiting processing of 
another node. When the awaited processing 
is completed, the status of this node should 
change. If the awaited processing is 
completed and this node remains in this 
state, then there is probably a software 
problem. 


Internal This state is used within ACF/VTAM to 
direct processing. It should never be dis- 
played. If it is, then there is probably a 
software problem. 


The first byte of RPRCURST and RPRDESST represents 
the resource status categories: 


Current State Desired State 

Value (Hex) Category Category 

00 Inactive Inactive 

01 Pending inactive Not used 

02 Connectable Connectable 

03 Reactivate Reactivate 

04 Pending active Not used 

05 Active Active 

06 Routable Routable 


The second byte of RPRCURST and RPRDESST gives the 
specific resource status. The following table shows the two 
bytes in combination (for example, value hex 0001 indicates 
a category of 00 and a specific code of 01). 
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Resource Status Codes 


Abbre- 
viation 
{Hex 

Value) 


ACTIV 
(0505) 


APEER 
(0501) 


CONCT 
(0200) 


CTD(1) 
(043 D) 
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Category 


Final 


Final 


Final 


Suspended 


Resource Status 


Active: The resource is in the 
active state. 


Backup Link Station Active: The 
resource is an active backup link 
station to which a subarea node is 
attached. 


Connectable: A VARY NET,ACT 
command has been completed for a 
switched or local physical or logical 
unit, or for an application program. 
A dial-in or dial-out request will be 
honored, but the resource is not 
active at this time. For application 
programs, an OPEN has not yet 
been issued. For a channel-attached 
resource, the device has not been 
powered on. 


Contacted (1): A link station was 
being activated and a Contacted 
request has been received. Because 
the NCP contacted is also being 
activated, the activation of the link 
station is suspended while the NCP 
activation proceeds. Activation 
processing for the link station will 
resume before activation of the 
NCP is completed. 








Abbre- 
viation 
(Hex 

Value) 


CTDER 
(041D) 


CTROQI 
(043A) 


Category 


Suspended 


Suspended 


Resource Status Codes 


Resource Status 


Contacted Error: A node, either 
a link station or a peripheral 
physical unit was being activated 
and a Contacted request was 
received indicating the Contact 
operation failed. For a peripheral 
PU, a request to deactivate the 
resource has been scheduled. For a 
link station, if the NCP it is trying 
to contact is also being activated, 
the link station activation will be 
suspended while the NCP activa- 
tion proceeds. Activation proc- 
essing for the link station will 
resume before activation of the 
NCP completes. A second contact 
failure will cause deactivation of 
the link station. 


Contacted (2) Request IPL: A 
node, either a link station or a 
peripheral PU, is being activated 

and the Contacted request indicates 
that reload is required. Fora 
peripheral PU, a request to de- 
activate the resource has been 
scheduled. For a link station, if 

the NCP it is trying to contact is 
also being activated, the link station 
activation will be suspended while 
the communication controller activa- 
tion proceeds. Activation processing 
for the link station will resume be- 
fore activation of the NCP completes. 
A second Contacted request indi- 
cating that reload is required will 
cause deactivation of the link 
station. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


CTINS 
(040F) 


DALUC 
(011E) 


DAPUC 
(011F) 


DEFND 
(0001) 
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Category 


Suspended 


Suspended 


Internal 


Short 
Transient 





Resource Status 


Contact (1) Not Sent: A link sta- 
tion reached the point in its activa- 
tion where a Contact request 
should be sent, but the NCP to be 
contacted was not in a suitable 
state. The link station’s activation 
will be suspended while the NCP’s 
activation proceeds. Activation 
processing for the link station will 
resume before activation of the 
NCP completes. 


DACTLU Complete: A DACTLU 
has been sent and the response 
received, but some higher-level 
node recovery processing has 
started. This node will remain in 
this state until the higher-level 
process redrives it. 


DACTPU Complete: A DACTPU 
has been sent as the result of a 
force deactivate or force reactivate 
command, and either the response 
was received or in the case of acom- 
munication controller, a route failed 
and a DACTPU request was received. 


Defined: A VARY NET, ACT 
command is being processed for a 
major node and the RDT segment 
has just been built. The major node 
and its subnodes are known to 
ACF/VTAM. The activation has 
been suspended while the proces- 
sing of the command moves from 
one internal ACF/VTAM dis- 
patching point to another. 





Abbre- 
viation 
(Hex 

Value) 


DUMPC 
(011B) 


FDSCC 


(0445) 


HLACC 
(042D) 


HLACF 
(0409) 


Category 


Suspended 


Internal 


Internal 


Internal 


Resource Status Codes 


Resource Status 


Dump Complete: A link station 
was used to dump an NCP and the 
dump is complete, but the recovery 
or deactivation of the NCP has not 
reached the point where link 
stations adjacent to that NCP are 
processed. For a recovery, that 
point is when the NCP’s load/dump 
procedure status is RESET. Fora 
deactivation, that point is when the 
NCP’s status is PRSET. 


Force Discontact Complete: A 
DISCONTACT has been sent as 

a result of a force deactivate or 
force reactivate command and the 
response to the DISCONTACT 
has been received. 


Higher-Level Activate Complete: 
The resource is being activated and 
its higher-level node has completed 
activation. For example, a local PU 
or LU is being activated, and the 
activation of the associated channel 
(such as PUB or UCB allocation) 
has completed. The activation of 
the resource is about to begin. 


Higher-Level Activate Failed: The 
resource was being activated, and 
activation of its higher-level node 
failed. For example, a local PU or 
LU was being activated, and PUB or 
UCB allocation has failed for its 
associated channel. A deactivate 
request was scheduled for the local 
PU or LU. 
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Resource Status Codes 





Abbre- 
viation 
{Hex 
Value) Category Resource Status 
IINOP Final Inactive (Inoperative): The 
(0005) resource has been deactivated by 
an INOP request or a forced | 
deactivation. ww) 
INACS Final Inactive with Sessions. If the 
(0006) resource is an LU, the node is in 
the inactive state, but may have 
active sessions. There is no LU- y 
w 


SSCP session, but the LU may 
have active LU-LU sessions. This 
state can occur when a cross- 
domain resource is made a same- 
domain resource as part of the 
takeover of the resources of an 
SSCP that failed. 


If the resource is a CDRM, the node 

is in an inactive state, but it sup- 

ports active cross-domain LU-LU 

sessions. In this state, there is no 
SSCP-SSCP session, but the CDRM 

may be supporting active cross- ; 
domain LU-LU sessions. This state esl 
can occur when: 


1. The virtual route used by the 
SSCP-SSCP session is inopera- 
tive or has been deactivated by 
a DACTVR (FORCE) 


2. Activate CDRM contention 
has occurred 


3. An unrecoverable error has been 
detected for the SSCP-SSCP ses- 
sion. The cross-domain active 
session, which used the SSCP- 
SSCP session to setup, will 
remain intact. 
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Abbre- 
viation 
(Hex 

Value} 


INACT 
(0003) 


INOP 
(0441) 


INVAP 
(0417) 


LLOQED 
(043B) 


Category 


Final 


Suspended 


Internal 


Suspended 


Resource Status Codes 


Resource Status 


Inactive: The resource is inactive. 


inoperative: An INOP request, 
route failure, or force reactivate 
command is being processed. 
Active user sessions have been ter- 
minated, and the resource is about 
to be reactivated, but must wait for 
a higher level node. 


Invalid ACTPU Response: A node, 
such as a communication controller 
or PU, is being activated, and the 
ACTPU request has been sent, but 
the associated response is invalid. 
Examples of invalid responses are: 
when the response unit has invalid 
format or indicates the PU is not in 
COLD or ERP state, or the resource 
has been loaded, and the contents 
ID is not the expected value. A 
request to deactivate the resource 
was scheduled. 


Lower Level Queued: A VARY 
NET, ACT command is being proc- 
essed for a communication con- 
troller and the RDT segment has 
just been built. The network names 
of the major node and its subnodes 
are known to ACF/VTAM. At least 
one of the subnode link stations has 
been queued on another link 
station queue, because it is an 
operand of the RNAME= keyword 
on the second communication 


25 





Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category Resource Status 





controller's VARY NET, ACT com- 

mand. The activation of the com- 
munication controller has been eas 
suspended while the processing of 

the command moves from one 

internal ACF/VTAM dispatching 

point to another. 


NACDR Internal Negative Activate CDRM Response: ea” 
(042F) A CDRM is being activated and the 

Activate CDRM request was sent, 

but the associated response was 

negative (the request failed). A 

request to deactivate the CDRM 

has been scheduled. 


NACTL Internal Negative Activate LU Response: A 

(0410) node, such as an application pro- 
gram or other LU was being activa- 
ted, and the Activate LU request 
was sent, but the associated re- 
sponse was negative (the request 
failed). A request to deactivate the 
resource was scheduled. 





NACTP Internal Negative Activate PU Response: A 

(0412) node, such as a communication 
controller or PU, was being activa- 
ted and the Activate PU was sent, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the resource 
was scheduled. 
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Abbre- 
viation 
(Hex 
Value) Category 
NADLK 
(0423) 


Internal 


NADST 
(0420) 


Internal 


NALNK 
(0415) 


Internal 


NANNA 
(0431) 


Internal 


Resource Status Codes 


Resource Status 


Negative Add Link Response: A 
channel link was being activated 
and an Add Link request was sent 
to the appropriate PU services. 
However, the associated response 
was negative and the request failed. 
A request to deactivate the resource 
was scheduled. 


Negative Add Link Station Re- 
sponse: A channel link station was 
being activated and an Add Link 
Station request was sent to the host 
PU. However, the associated 
response was negative and the 
request failed. A request to deacti- 
vate the resource was scheduled. 


Negative Activate Link Response: 
A line was being activated, and the 
Activate Link request was sent, but 
the associated response was nega- 
tive (the request failed). A request 
to deactivate the line has been 
scheduled. 


Negative Allocate Node Network 
Address: A node, such as a DR- 
added PU or LU, was being acti- 
vated, and the Request Network 
Address Assignment request was 
sent to the appropriate PU services, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the resource 
was scheduled. 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category 


NASNA Internal 
(0426) 


NCONO Internal 
(0400) 


NCONT Internal 
((041C) 


NEVAC Final 
(0004) 
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Resource Status 


Negative Allocate Subnode Net- 
work Addresses: A node, such as 
a local or switched physical unit, is 
being connected and the Request 
Network Address Assignment 
request has been sent to the appro- 
priate PU services. However, the 
associated response was negative 
and the request failed. A request to 
disconnect the resource was 
scheduled. 


Negative Connect Out Response: A 
node, such as a local or switched 
physical unit, was being connected 
and the Connect Out request was 
sent to the appropriate PU services, 
but the associated response was 
negative and the request failed. A 
request to disconnect the resource 
was scheduled. 


Negative Contact Response: A 
node, such as a link station or PU, 
was being activated and the Contact 
request was sent, but the associated 
response was negative (the request 
failed). A request to deactivate the 
resource has been scheduled. 


Never Activated: The resource 
has never been activated. 











wy 


Abbre- 

viation 

(Hex 

Value) Category 


NLOAD Internal 
(043C) 
NNAUV Internal 
(0403) 
NSARV Internal 
(041A) 
NSDT Internal 
(0428) 





Resource Status Codes 


Resource Status 


Negative Load Response: An NCP 
was being activated and a Load 
Request was sent to the appropriate 
PU services, but the associated 
response was negative and the 
request failed. A request to deacti- 
vate the NCP was scheduled. 


Negative Set LU Control Vector 
Response: A node, such as a 
switched or dynamically added 
logical unit, was being connected 
and the Set Control Vector request 
with the LU Control Vector was 
sent, but the associated response 
was negative and the request failed. 
A request to disconnect the resource 
was scheduled. 


Negative Set Subarea Routing 
Control Vector: A node, such as 

a link station, was being activated 
and the Set Control Vector request 
with the Subarea Routing Control 
Vector was sent, but the associated 
response was negative and the re- 
quest failed. A request to deacti- 
vate the resource was scheduled. 


Negative Start Data Traffic Re- 
sponse: A communication con- 
troller was being activated and the 
Start Data Traffic request was sent, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the communi- 
cation controller was scheduled. 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category 


NSNCP Internal 
(042E) 


NSSSV Internal 
(0405) 


NSTD Internal 
(042A) 


NVYLM Internal 
(0436) 
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Resource Status 


Negative Switch to NCP Response: 
A PEP link was being activated, and 
the SW to NCP request was sent, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the PEP link 
was scheduled. 


Negative Set SDLC Secondary 
Station (SSS) Control Vector: A 
node, such as a DR-added PU, or 

a switched PU, was being con- 
nected, and the Set Control Vector 
Request with the SSS control 
vector was sent, but the associated 
response was negative and the 
request failed. A request to dis- 
connect the node was scheduled. 


Negative Set Time and Date 
Response: A node, such as a com- 
munication controller, was being 
activated, and the Set Time and 
Data request was sent, but the 
associated response was negative, 
and the request failed. A request to 
deactivate the node was scheduled. 


Negative Operator Query (VFLYM) 
Response: The resource was being 
activated and the response to the 
ACF/VTAM message IST361A or 
5D61A was to terminate the NCP’s 
activation. A request to deactivate 
the resource has been scheduled. 





Abbre- 

viation 

(Hex 

Value) Category 


PABCN Short 
(010B) Transient 


PABCO Short 
(0116) Transient 


PACDR Long 
(0430) Transient 


Resource Status Codes 


Resource Status 


Pending Abandon Connection 
Response: A node, such as a 

local or switched PU, is about to 
become disconnected. The 
Abandon Connection request has 
been sent to the appropriate PU 
services, but the associated response 
has not been received. 


Pending Abandon Connect Out 
Response: A node, such as a local 
or switched PU, is being discon- 
nected and the Abandon Connect 
Out request has been sent to the 
appropriate PU services, but the 
associated response has not been 
received. 


Pending Activate CDRM Response: 
A CDRM is being activated and the 
Activate CDRM request has been 
sent, but the associated response 
has not been received. The sending 
of this request may have to wait 
for the availability of a virtual 
route. If one or more explicit 
routes are operative, this should 

be a short transient state while 
route activation proceeds. If no 
routes are operative, this may be 

a long transient state while ACF/ 
VTAM waits for connectivity to 

be established along the route. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PACTL 
(0411) 


PADLK 
(0421) 


PADST 
(0419) 


PALNK 
(0416) 


PALUC 
(0434) 
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Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Resource Status 


Pending Activate LU Response: A 
node, such an an application pro- 
gram or other logical unit, is being 
activated and the Activate LU re- 
quest has been sent, but the associ- 
ated response was not received. 


Pending Add Link Response: A 
channel link is being activated and 
an Add Link request was sent to 
the appropriate PU services, but 
the associated response has not 
been received. 


Pending Add Link Station Re- 
sponse: A channel link station is 
being activated and an Add Link 
Station request was sent to the 
appropriate PU services, but the 
response has not been received. 


Pending Activate Link Response: 
A line is being activated, and the 
Activate Link request has been 
sent, but the associated response 
was not received. 


Pending Activate LU Cleanup 
Response: An active LU is under- 
going recovery processing. An 
ACTLU request has been sent, but 
the associated response has not 
been received. 














Abbre- 
viation 
7 ; ( Hex 
ww Value) Category 


PANNA Short 
(0432) Transient 


PAPU1 Long 
(0413) Transient 


PAPU2 Long 
(0425) Transient 





Resource Status Codes 


Resource Status 


Pending Allocate Node Network 
Address: A node, such as a dy- 
namically added physical unit or 
logical unit, is being activated and 
the Request Network Address 
Assignment request has been sent 
to the appropriate PU services, but 
the associated response was not 
received. 


Pending Activate PU (1) Response: 
An NCP is being activated, and may 
need to be loaded, ACTPU was 
sent, but the associated response 
has not yet been received. The 
sending of this request may have to 
wait for the availability of a virtual 
route. If one or more explicit 
routes are operative, this should be 
a short transient state while route 
activation proceeds. If no routes 
are operative, this may be a long 
transient state while ACF/VTAM 
waits for connectivity to be 
established along the route. 


Pending Activate PU (2) Response: 
A physical unit is being activated. 
ACTPU has been sent, but the as- 
sociated response has not yet been 
received. For a subarea PU, the 
sending of this request may have to 
wait for the availability of a virtual 
route. If one or more explicit 
routes are operative, this should ef- 
fectively be a short transient state 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category Resource Status 





while route activation proceeds. If 

no routes are operative, this may be 

a long transient state while ACF/ 

VTAM waits for connectivity to wey 
be established along the route. 


PASNA Short Pending Allocate Subnode Network 

(0427) Transient | Addresses: A node, such as a local 
or switched physical unit, is being ; e 
connected and the Request Net- ed 


work Address Assignment request 
has been sent to the appropriate 
PU services. However, the associ- 
ated response was not received. 


PCONO Short Pending Connect Out Response: A 

(0401) Transient node, such as a local or switched 
physical unit, is being connected 
and the Connect Out request has 
been sent to the appropriate PU 
services, but the associated response 
was not received. 


PCON1 Short Pending Contact (1) Response: A —— 

(041E) Transient node, such as a link station is being ww 
activated, and the first Contact re- 
quest was sent to the appropriate 
PU services, but the associated re- 
sPonse was not received. 


PCON2 Short Pending Contact (2) Response: A 

(0422) Transient node, such as a PU or link station, 
is being activated, and the Contact 
request (second attempt for link 
station) has been sent to the appro- 
priate PU services, but the associ- 
ated response has not been 
received. 
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Abbre- 
viation 
(Hex 

Value) 


PCTD1 
(041F) 


PCTD2 
(0424) 


Category 


Long 
Transient/ 
Suspended 


Long 
Transient/ 
Suspended 


Resource Status Codes 


Resource Status 


Pending Contacted (1) Request: If 
the resource is a link station it is 
being activated, and a positive 
Contact response was received but 
the associated Contacted request 
was not received. An NCP will also 
be found in this state (in this case 

a suspended state) during activation 
while waiting for an adjacent link 
station to be activated. 


Pending Contacted (2) Request: If 
the node is a link station or peri- 
pheral PU, it is being activated and 
a Contact request was sent and the 
response received, but the associ- 
ated Contacted request has not 
been received. An NCP will also be 
found in this state (it is a suspended 
state in this case) during activation 
while waiting for an adjacent link 
station connected to it to be acti- 
vated. The difference between 
PCTD2 and PCTD1 is that an NCP 
in the PCTD1 state may be loaded 
if a Contacted request is received 
for an adjacent link station indica- 
ting that the communication con- 
troller needs to be loaded, whereas, 
in the PCTD2 state, both the 
adjacent link station and the NCP 
would be deactivated, since a load 
has already been performed or the 
NCP has been activated with 
LOAD=NO. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PDACL 
(010F) 


PDACP 
(0110) 


PDANC 
(0442) 


PDANS 
(0104) 


PDELR 
(010E) 
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Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 





Resource Status 


Pending DACTLU Response: A 
node, such as an application pro- 
gram or a logical unit, is being dis- 
connected or deactivated. The 
DACTLU request has been sent, 
but the associated response has not 
been received. 


Pending DACTPU Response: A 
node, such as a communication 
controller or physical unit, is being 
disconnected or deactivated. The 
DACTPU request has been sent, 
but the associated response has 
not been received. 


Pending DACTPU ANSC: A 
DACTPU has been sent to the re- 
source but the associated response 
has not been received. The re- 
source was being activated when an 
Auto Network Shutdown Complete 
(ANSC) RU was received. This re- 
quest causes the SSCP to reset the 
SSCP-PU session and then resume 
the activation procedure. 


Pending Inactivate ANS Processing: 
The Abandon Connect In request 
unit has been sent for a node such 
as a switched link. 


Pending Delete Network Resource 
Response: A node, such as an ap- 
plication program, is being discon- 
nected, The Delete Network Re- 
source request has been sent to the 
appropriate PU services, but the asso- 
ciated response has not been received. 





Abbre- 
viation 
(Hex 

Value) 


PDISC 
(010D) 


PDLNK 
(0112) 


PDLUC 
(011D) 


PDPA1 
(0443) 


Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 





Resource Status Codes 


Resource Status 


Pending Discontact Response: A 
node, such as a link station or 
physical unit, is being deactivated 
or disconnected. The Discontact 
request has been sent to the appro- 
priate PU services, but the associ- 
ated response has not been 
received. 


Pending DACTLINK Response: A 
line or local device is being deacti- 
vated, and the DACTLINK request 
has been sent to the appropriate PU 
services, but the associated response 
has not been received. 


Pending Deactivate LU Cleanup: 
An active LU is undergoing error 
recovery processing and a DACTLU 
request has been sent, but the asso- 
ciated response has not been 
received. 


Pending DACTPU (ACT1): A 
DACTPU has been sent to the re- 
source but the associated response 
has not been received. 


The NCP was being activated and 
was found already loaded. This 
state is exited when the DACTPU 
response is received and processing 
will continue from the beginning. 
Another attempt to load will 

be allowed. 
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Resource Status Codes 


Abbre- 

viation 

(Hex . 
Value) Category Resource Status 

PDPA2 Short Pending DACTPU (ACT2): A 


(0440) Transient DACTPU has been sent to the 
resource but the associated re- _ 
sponse has not been received. ww 


lf the resource is an NCP, it was 
being activated and a load was 
performed. Once the DACTPU 
response is received, the activation 
of the NCP will proceed. If the 
resource is a BSC 3270 PU, a 
General Poll Failure occurred and 
the DACTPU was sent to clean up 
internal control blocks. When the 
response is received, an ACTPU 
will be sent. 





PFDCP Short Pending Force DACTPU Response: 

(0440) Transient A DACTPU has been sent as a re- 
sult of a force reactivate or force 
deactivate command against a node, 
such as a communication control- 
ler. The response has not been 


received. a 


PFDLU Short Pending Force DACTLU Response: 

(0120) Transient A DACTLU has sent as a result of a 
force deactivate command for the an 
LU, but the response has not yet nd 
been received. 


PF DMP Long Pending Dump Response: DUMP is 

(0119) Transient being performed of an NCP over a 
link station and has not yet com- 
pleted processing. 
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Abbre- 

viation 

(Hex 

Value) Category 


PFDSC Short 
(042C) Transient 


PFNNA Short 
(011C) Transient 


PFSNA Short 
(010C) Transient 


PHLAC Suspended 
(040A) 





Resource Status Codes 


Resource Status 


Pending Force Discontact Re- 
sponse: A PU is being force deacti- 
vated or force reactivated and the 
Discontact request has been sent to 
the appropriate PU services, but 
the associated response has not 
been received. 


Pending Free Node Network Ad- 
dress: A node, such as a dynami- 
cally added PU or LU is being de- 
activated. The Free Network Ad- 
dress request has been sent to the 
appropriate PU services, but the 
associated response has not been 
received. 


Pending Free Subnode Network 
Addresses: A node, such as a local 
or switched PU, is being discon- 
nected. The Free Network Address 
request has been sent to the appro- 
priate PU services, but the associa- 
ted response has not been received. 


Pending Higher-Level Activation: 
A node is awaiting activation of 

its higher-level node. For example, 
a local PU or LU is being activated, 
and the request to activate the 
associated channel, (that is, the 
associated PUB or UCB) has not 
completed. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PHLIN 
(0102) 


PINAC 
(0100) 


PLOAD 
(040E) 


PLSTC 
(043F) 
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Category 


Suspended 


Long 
Transient 


Long 
Transient 


Suspended 


Resource Status 


Pending Higher-Level Deactivation: 
A node is inactive and its higher- 
level node is being deactivated. For 
example, a local PU is inactive and 
the associated channel PUB or UCB 
is being deallocated. 


Pending Inactive: CDRM is being 
deactivated. This is a long transient 
state because all cross-domain ses- 
sions involving the CORM must be 
terminated before the CDRM is 
deactivated. 


Pending Load: An NCP is being 
activated and a loading operation 
has begun, or a peripheral PU, 

such as an 8775, being activated has 
requested a load and the SSCP sent 
the load request to an application 
program defined in the CNM 
routing tables. A response to the 
load request has not been received. 


Pending Load Station Conditional: 
Activation processing for an NCP is 
waiting for the link station over 
which the NCP will be loaded to 
become available. When the link 
station is available, ACF/VTAM 
will perform a conditional load if 
the link station is channel-attached, 
or otherwise an unconditional load. 











Abbre- 
viation 
(Hex 

Value) 


PLSTU 
(040D) 


PMALD 
(0446) 


PMATM 
(0447) 


PNAUV 


(0404) 


PNFY1 
(0113) 


Category 


Suspended 


Long 
Transient 


Long 
Transient 


Short 


Transient 


Long 
Transient 





Resource Status Codes 


Resource Status 


Pending Load Station Uncondi- 
tional: Activation processing for 
an NCP is waiting for the link sta- 
tion over which the NCP will be 
loaded to become available. When 
the link station is capable of being 
used for loading, a load of the NCP 
will be done. 


Pending Migration ACTPU Load/ 
Dump Procedure: For an NCP 
session On a migration route, a 
session recovery loop has been sus- 
pended due to an ongoing load or 
dump operation. 


Pending Migration ACTPU Timer: 
An NCP, attempting session recov- 
ery On a migration route, is waiting 
for expiration of a time interval 
before retrying session activation. 


Pending Set LU Control Vector 
Response: A node, such as a 
switched or dynamically added 
logical unit, is being connected and 
the Set Control Vector request with 
the LU Control Vector has been 
sent to the appropriate PU services, 
but the associated response has not 
been received. 


Pending Notify(1) Request: A 
node, such as an LU, is being de- 
activated or disconnected. The re- 
quest to terminate user sessions has 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category Resource Status 





been scheduled, but the Notify 

request indicating that the user / 
sessions have ended has not yet —" 
been received. 


PNFY2 Long Pending Notify(2) Request: A 

(0108) Transient node, such as a logical unit, is about 
to become connectable and the re- ee 
quest to terminate any queued user ‘a? 


sessions has been scheduled. How- 
ever, the Notify request indicating 
that the user sessions have ended 
has not yet been received. 


PNFY3 Long Pending Notify(3) Request: A 

(0105) Transient node is about to become inactive 
and the request to terminate 
queued user sessions has been 
scheduled, However, the Notify 
request indicating that the user 
sessions have ended has not yet 
been received. 





POAS1 Long Pending Operator Query 

(0437) Transient (AUTOSYN1) Response: A com- 
munication controller is being 
activated and message IST183A or 
5B83A, which asks if the commu- 
nication controller should be re- 
loaded or resynchronized, has been 
issued. The message was sent after 
the communication controller was 
contacted but before an SSCP-PU 
session was established. The reply 
has not been received. 
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Abbre- 
viation 
(Hex 

Value) 


POAS2 
(0438) 


PREQC 
(0402) 


PRMPO 
(0103) 


PRSET 
(0101) 


PSARV 
(041B) 


Category 


Long 
Transient 


Long 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 





Resource Status Codes 


Resource Status 


Pending Operator Query 
(AUTOSYN2) Response: A com- 
munication controller is being 
activated and message IST183A or 
5B83A, which asks if the commu- 
nication controller should be re- 
loaded or resynchronized, has been 
issued. The message was sent after 
an SSCP-PU session was established 
with the communication controller. 
The reply has not been received. 


Pending Request Contact Request: 
A node, such as a local or switched 
physical unit, is being connected and 
the Connect Out response has been 
received, but the Request Contact 
request has not been received. 


Pending RMPO Response: A link 
station is being deactivated and the 
NCP attached to it has to be 
powered off. A Remote Power Off 
request has been sent and the 
response has not been received. 


Pending Reset: The resource is 
inactive, but the network name is 
still known to ACF/VTAM. 


Pending Set Subarea Routing Con- 
trol Vector Response: A node, such 
as alink station, is being activated 
and the Set Control Vector request 
containing a Subarea Routing Con- 
trol Vector has been sent to the appro- 
priate PU services, but the asso- 
ciated response has not been received. 
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Resource Status Codes 


Abbre- 

viated : 

(Hex — r 

Value) Category Resource Status 

PSDT Short Pending Start Data Traffic (SDT) 

(0429) Transient Response: A node, such as a com- 
munication controller is being . 
activated, and the Start Data Traf- ed 
fic request was sent, but the associ- 
ated response was not received. 

PSNCP Short Pending Switch to NCP Response: | 

(0414) Transient |§ A PEP link is being activated, and wo 
the Switch to NCP request was 
sent, but the response has not been 
received. 

PSSSV Short Pending Set SDLC Secondary 


(0406) Transient Station (SSS) Control Vector 
Response: A switched physical 
unit is being connected, or a DR 
added PU is being activated, and 
the Set Control Vector Request 
containing an SSS control vector 
has been sent to the appropriate 
PU services, but the associated 


response has not been received. 9 
PSTD Short Pending Set Time and Date 
(042B) Transient Response: A communication con- 


troller is being activated, and the 

Set Control Vector request con- vo 
taining a Set Time and Date Con- rd 
trol Vector was sent, but the 

associated response was not re- 

ceived. 
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Abbre- 
viation 
(Hex 

Value) 


PSUBR 
(0504) 


PSUB1 
(0115) 


PSUB2 
(010A) 


Category 


Suspended 


Suspended 


Suspended 


Resource Status Codes 


Resource Status 


Pending Subnode Release: An 
acquired communication control- 
ler that was activated before it 
was acquired is being released; 
that is, a request to release the 
subnodes in the acquired portion 
of the communication controller 
is in progress. 


Pending Subnode Deactivate (1): 
A node supporting subnodes, for 
example, an application program 
segment, communication con- 
troller, link, or PU is being deacti- 
vated or disconnected and is wait- 
ing for its subnodes to complete 
deactivation processing before 
Proceeding with its own deactiva- 
tion. (The differences between 
PSUB1, PSUB2, and PSUB3 vary 
for the node type. The different 
states are used to determine the 
next step to be taken in deacti- 
vating this node once its subnodes 
complete processing.) 


Pending Subnode Deactivate (2): 
A node supporting subnodes, for 
example, an application program 
segment, Communication control- 
ler, link, or PU is being deactivated 
or disconnected and is waiting for 
its subnodes to complete deactiva- 
tion processing before proceeding 
with its own deactivation. (The dif- 
ferences between PSUB1, PSUB2, 
and PSUB3 vary for the node type. 


45 


Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PSUB3 
(0107) 


PSWEP 
(0111) 


PTRM1 
(0114) 


46 


Category 


Suspended 


Short 
Transient 


Short 
Transient 


Resource Status 


The different states are used to 
determine the next step to be taken 
in deactivating this node once its 
subnodes complete processing.) 


Pending Subnode Deactivate (3): A 
node supporting subnodes, for ex- 
ample, an application program seg- 
ment, communication controller, 
link, or PU is being deactivated or 
disconnected and is waiting for its 
subnodes to complete deactivation 
processing before proceeding with 
its own deactivation. (The differ- 
ences between PSUB1, PSUB2, and 
PSUB3 vary for the node type. The 
different states are used to deter- 
mine the next step to be taken in 
deactivating this node once its 
subnodes complete processing.) 


Pending Switch to EP Response: A 
PEP link has been deactivated. The 
Switch to EP Mode request has 
been sent to the appropriate PU 
services, but the associated response 
has not been received. 


Pending Terminate(1) Response: A 
node, such as an LU, is being deac- 
tivated or disconnected, The 
request to terminate user sessions 
has been scheduled, but the associ- 
ated response has not yet been 
received. 








Abbre- 
viation 
(Hex 

Value) 


PTRM2 
(0109) 


PTRM3 
(0106) 


PVYLM 
(0435) 


POS5A 
(0118) 


P284A 
(0408) 


Category 


Short 
Transient 


Short 
Transient 


Long 
Transient 


Long 
Transient 


Long 
Transient 





Resource Status Codes 


Resource Status 


Pending Terminate(2): A node, 
such as an LU, is about to be- 
come connectable and the request 
to terminate queued user sessions 
has been scheduled. However the 
associated response has not yet 
been received. 


Pending Terminate(3) Response: 
An LU is about to become inactive 
and the request to terminate 
queued user sessions has been 
scheduled, but the associated 
response has not yet been received. 


Pending Operator Query (VF YLM) 
Response: The resource is being 
activated and the ACF/VTAM 
operator message IST361A or 
5D61A has been issued, but the 
reply has not yet been received. 
Message 1ST361A or 5D61A asked 
the operator if he wanted to load 
the NCP or terminate the NCP’s 
activation. 


Pending Operator Query Response: 
An error recovery procedure (ERP) 
issued message ISTO95A or 5AQ95A, 
asking whether an ERP DUMP is 
desired. The reply has not been 
received. 


Pending Operator Query Response: 
Acommunication controller is being 
recovered and message IST284A or 
5C84A, asking whether the com- 
munication controller should be 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


RACTH 
(0301) 


RACTN 
(0300) 


RADDF 
(0433) 


RDIAL 
(0201) 


RELSD 
(0002) 


Category 


(See Note) 


(See Note) 


Internal 


(See Note) 


Final 





Resource Status 


reloaded, has been issued. The 
reply has not been received. 


Reactivate at Higher Level: The 
resource is being deactivated and, 
once inactive, will wait for its reac- 
tivation to be driven by a higher- 
level node.? 


Reactivate at this Level: The 
resource is being deactivated and 
will then be reactivated at this 
level." 


RDTADD Failed: A node was 
being activated and the request to 
add the associated network address 
to the ACF/VTAM’s network 
address table has failed. A request 
to deactivate the resource has been 
scheduled. 


Redial: A switched PU is being 
disconnected and an attempt to 
redial the PU will be made once 
disconnection is complete.' 


Released: A physical unit has been 
released or it exists in the unowned 
portion of an activated-before- 
acquired communication controller 
and has not yet been acquired. 


1 This is a desired state only. 
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Abbre- 

viation 

(Hex 

Value) Category 


RESET Final 
(0000) 


RINAC Long 
(0600) Transient 


RRLSD Long 
(0601) Transient 


183 AF Internal 
(0418) 





Resource Status Codes 


Resource Status 


Reset: As a current state, this 
means that the RDT segment has 
been built but has not been 
processed by the SSCP. This value 
for an LU can also mean that a 
VARY NET,REL command for 
the associated PU has been com- 
pleted. 


As the NCP’s load dump procedure 
status, this state means that no load 
or dump procedure is in progress. 


Routable, Inactive: A MODIFY 
L.L2 command is being processed 
for an inactive DR-added PU. 
When the LL2 test is terminated 
the PU will be returned to the in- 
active state. 


Routable, Release: A MODIFY 
L.L2 command is being processed 
for a released DR-added PU. When 
the LL2 test is terminated, the PU 
will be returned to the released 
state. 


Operator Query (AUTOSYNCH) 
Failed: A request to issue message 
IST183A or 5B83A was scheduled, 
but the message could not be issued. 
Processing continues as if the reply 
was negative. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


284 AF 
(0407) 


TRACT? 
(03) 


TRPAR? 
(02) 


TRPDR? 
(01) 


TRREsS} 
(00) 


Category 


Internal 


Final 


Short 
Transient 


Short 
Transient 


Final 





Resource Status 


Operator Query Failed: A request 
to issue message 5C84A has been 
scheduled, but the message could 
not be issued. Processing continues 
as if the reply was negative. 


Trace Active: The trace indicated 
is active for this line. 


Pending Active Trace Response: 
The trace is being activated and the 
ACTTRACE request has been sent, 
but the associated response has not 
been received. 


Pending DACTTRACE Response: 
The trace is being deactivated and a 
DACTTRACE request has been 
sent, but the associated response 
has not been received. 


Trace Reset: The trace indicated 
is inactive for this line. 


1 This value may appear in a 1-byte field containing the 
line trace status. 
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Resource Status Codes 


Status Modifiers 


The following status modifiers can appear in positions 4 and 
5 of the state field. 


Status 
Modifier Meaning 


/B A BIND is in progress for this node. 

Ic A session between this node and its controlling 
application program is active, pending active, 
or queued. 

Is A session is in progress for this logical unit or 


terminal. This will not appear if one of the 
other status modifiers is present. 


/U A CLEAR preceding UNBIND or an UNBIND 
is in progress for this node. 


Resource Status 


The following resource status information can appear in char- 
acter positions 6 through 10 in the statexxxxx field. 


When an NCP is displayed with the EVERY, ACTIVE, or 
INACTIVE keyword, the status of the NCP links can be 
modified with ‘’N’’ in the 7th character position, if the 
link was not originally owned by the host processing the 
DISPLAY, and the link has been ‘‘acquired.”’ 


The resource status code ‘’T’’ in the 10th position shows 
that a resource (link, PU, or LU) is attached through the 
programmed resource capability of the NCP. 


The status of a dynamically added PU or LU can be modi- 


fied with ‘’D’’ in the 10th position to show that the resource 
has been added by dynamic reconfiguration. 
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Resource Status Codes 


If a cross-domain resource was created dynamically, a ‘“Y”’ 
will appear in the 10th character position. 


When a resource is defined as a shadow resource, an ’’S” 
will appear in the 8th character position. This indicator may 
be combined with other modifiers. 


If a cross-subarea link or link station has been automatically 
activated, an ‘’I’’ will appear in the 9th and 10th character 
positions. Otherwise, an active cross-subarea link or link 


station is displayed with an “E’’in the 10th character position. 


See ACF/VTAM Operation for an explanation of automatic 
and other types of actions. 


If a link station is functioning as a backup for another link 


station (in certain migration situations), a ‘’B’’ will be dis- 
played in the 10th character position. 
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System Completion Codes (OS/VS) 


This section contains only the OS/VS system completion 
codes related to ACF/VTAM. The remainder of the system 
completion codes are listed in the appropriate OS/VS 
Message Library: System Codes. 


System completion codes indicate that the control program 
has determined that a task cannot continue processing and 
expect valid results. For example, an error may have 
occurred during the execution of a user’s application program 
and was detected by ACF/VTAM. In such a case, processing 
of the task is terminated, and a completion code is supplied 
which indicates the reason for the termination. When appro- 
priate to the error, the explanation of the completion code 
suggests a programmer response intended to correct the 
reason for the abnormal termination. If the error cannot be 
corrected by correcting program code, the problem deter- 
mination action should be followed. The problem deter- 
mination table for the system completion codes is at the end 
of this section. 


OA7 


Explanation: During ACF/VTAM HALT NET, 
CANCEL processing, ACF/VTAM found that a 
TPEND exit routine did not exist or could not be 
scheduled for each access method control block 
(ACB) opened by the user’s application program. 


System Action: The user’s task is abnormally 
terminated. 


Programmer Response: None. 
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- System Completion Codes 


0A8 


OA9 


Explanation: ACF/VTAM detected an error that 
occurred during the execution of a user’s application 
Program. The contents of the low-order 2 bytes of 
register 15 indicates the cause of the error: 


Register 15 

Contents in 

Hexadecimal: Explanation: 

2101 An ACF/VTAM validity check of 
the user’s request parameter list 
(RPL) failed because the RPL does 
not have the same protection key 
as the application programs’s TCB. 

7001 The user's request parameter list 


(RPL) or event control block 
(ECB) is invalid. 


7003 The user’s request parameter list 
(RPL) is invalid. 


System Action: The task abnormally terminates. 


Programmer Response: Probable user error. 
Verify that the RPL and ECB pointers are correct 
and execute the job step again. 


Explanation: An error occurred during the execu- 
tion of an ACF/VTAM module. The contents of 
the low-order 2 bytes of register 15 indicate the 
cause of the error. 


Register 15 

Contents in 

Hexadecimal: Explanation: 

0000 An ACF/VTAM HALT NET, 


CANCEL command has been 
processed successfully. 


3141 An ACF/VTAM destination vector 
table (DVT) entry is invalid for 
the defined attachment. 











Register 15 
Contents in 
Hexadecimal: 


7001 


7002 


7003 


7004 


7005 


7071 


7141 


10F 1 


System Completion Codes 


Explanation: 


An ACF/VTAM application pro- 
gram has specified an invalid 
RPL or ECB. 


An ACF/VTAM request for 
storage failed. 


An ACF/VTAM request to re- 
lease storage failed because the 
storage had already been released. 


ACF/VTAM could not obtain a 
local storage lock. 


ACF/VTAM was unable to re- 
store its registers after a user 
exit routine returned to 
ACF/VTAM. 


A RELSTORE was issued for 
a previously freed buffer. 


Control cannot be passed to the 
proper ACF/VTAM module. 
Either an ACF/VTAM aesti- 
nation vector table (DVT) entry 
is invalid for the defined attach- 
ment or ACF/VTAM storage has 
been altered. 


The ABEND was issued by the 
ACF/VTAM STAE retry routine 
so that the user recovery routine 
(STAE exit routine) could get 
control. 


System Action: The task that initiated the ACF/ 
VTAM request abnormally terminates. 


Programmer Response: None. 
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System Completion Codes 


OAA 


OAB 
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Explanation: An abend condition occurred during 
execution of ACF/VTAM. ACF/VTAM'’s func- 
tional recovery routines (F RRs) were unable to 
associate the failure with any particular TCB in 

the address space. 


System Action: All the tasks in the address 
space are abnormally terminated. 


Programmer Response: None. 


Explanation: An error occurred while TSO/ 
VTAM was in operation and a VTIOC module was 
executing an ACF/VTAM macro instruction. The 
contents of the 2 low-order bytes of register 15 
indicate the cause of the error: 


Register 15 
Contents in 
Hexadecimal: Explanation: 


0101 The terminal input manager for 
IBM 3767, IBM 3770, and NTO 
terminals (IKTIMLU1) encoun- 
tered an unrecoverable error while 
executing an ACF/VTAM macro 
instruction that uses a request 
parameter list (RPL). 


0102 The terminal output manager for 
IBM 3767, IBM 3770, and NTO 
terminals (IK TOMLU1) encoun- 
tered an unrecoverable error while 
executing an ACF/VTAM marco 
instruction that uses an RPL. 


0103 The terminal input manager for 
IBM 3270 SNA terminals 
(IKTIMLUO or IKTIMLU2) en- 
countered an unrecoverable error 
while executing an ACF/VTAM 
macro instruction that uses an 
RPL. 




















Register 15 
Contents in 


way’ Hexadecimal: 


0104 
—_ 

0105 
ow’ 

0201 

0202 
—_ 
ww 0203 





System Completion Codes 


Explanation: 


The terminal output manager for 
IBM 3270 SNA terminals 

(IK TOMLUO or IKTOMLU2) en- 
countered an unrecoverable error 
while executing an ACF/VTAM 
macro instruction that uses an 
RPL. 


The VTIOC LOSTERM exit rou- 
tine encountered an error during 

execution of a BIND or UNBIND 
command that used an RPL. 


The error occurred during initial- 
ization of a TSO/VTAM user ad- 
dress space. An application 
program ID problem was encoun- 
tered while executing ACF/VTAM 
OPEN macro instruction. 


The error occurred during execu- 
tion of an ACF/VTAM OPEN mac- 
ro instruction. The ERROR field 
of the ACB indicates the problem. 
The values that can be set in the 
ERROR field are shown in Part 3, 
“Programming,” in the section 
titled, “ACB ERROR Field 
Values.’’ 


The error occurred during execu- 
tion of an ACF/VTAM CLOSE 
macro instruction. The code in the 
ERROR field of the ACB is hex 42, 
indicating that the ACB has been 
closed but an ACF/VTAM error 
has prevented the successful dis- 
connection of one or more TSO 
terminals. 
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System Completion Codes 


OAC 


58 


System Action: The terminal session in which the 
error occurred terminates. 


Programmer Response: None. 


Explanation: The terminal control address space 
(TCAS) was unable to continue its normal pro- 
cessing due to an error. The 2 low-order bytes 
of register 15 and TCAS work area (TWAR) field 
TWARSON both contain the reason code that 
indicates the cause of the error: 


Reason 

Code in 

Hexadecimal: Explanation: 

00 STOP command was entered. 

04 Invalid START command was 
issued. 

10 The TCAS main task was unable 


to attach the ACF/VTAM inter- 
face subtask. 


14 The TCAS main task was unable 
to attach the user interface sub- 
task. 

18 The TCAS main task was unable 


to attach the console communi- 
cation subtask. 


1c TCAS was unable to obtain stor- 
age for the TCAS table (TCAST) 
in the common service area 
(CSA). 


20 The TCAS main task abnormally 
terminated and was unable to 
recover. 











OAD 


Reason 
Code in 
Hexadecimal: 


30 


34 


38 


System Action: 


System Completion Codes 


Explanation: 


The ACF/VTAM interface subtask 
abnormally terminated and was 
unable to recover. 


The user interface subtask abnor- 
mally terminated and was unable 
to recover. 


The console communication sub- 
task abnormally terminated and 
was unable to recover. 


TCAS abnormally terminates. 


Operator Response: Reply ‘‘DUMP” to TCAS 
termination message 1KT012D to obtain a dump. 


Explanation: An error occurred while TSO/VTAM 
was in operation and VTIOC’s queue manager was 
executing a GETCELL or FREECELL macro 
instruction. The contents of the 2 low-order bytes 
of register 15 indicate the cause of the error: 


Register 15 
Contents in 
Hexadecimal: 


0108 


010C 


0110 


020C 


Explanation: 


The cell address supplied to the 
FREECELL macro instruction 
was invalid. 


No cell pool existed for the 
FREECELL request. 


An invalid cell pool 1D was 
specified for the FREECELL 
request. 


No cell pool existed for the 
GETCELL request. 
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System Completion Codes 


Register 15 
Contents in 
Hexadecimal: Explanation: 





0210 An invalid cell pool 1D was speci- 
fied for the GETCELL request. 


System Action: The queue manager abnormally 
terminates, and the terminal session in which the 
error occurred terminates. 





Programmer Response: None. 
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Cancel and Function Codes (VSE) 


When an ACF/VTAM routine issues CANCEL, register 15 
and the TIBCNCL field in the task information block (TIB) 
contains codes that aid in determining the reason for the can- 
celation. A cancel code is set in the TIB and a function code 
is set in register 15. The cancel code also appears at the end 
of message 5J97!: 


5J971 VTAM CANCELLED FOR INVALID 
CONDITION cancel code 


Note: This message is also issued without a cancel code 
under some conditions. See ACF/VTAM Messages and 
Codes for more information. 


Cancel Codes 


Cancel codes are set in the VSE TIB cancel fields (hex 1A). 
This field is found at displacement hex 01 in the PIB. For 
information about the relationship between the TIB and 
ACF/VTAM control blocks, see ACF/VTAM Diagnosis 
Reference. Possible cancel codes are: 


Hex 40 The application program task was canceled 
because ACF/VTAM terminated. 


Hex 41. ACF/VTAM terminated in this task with the 
function code indicated. 


If the hex 40 is set, message 5J95I is issued: 


5J95!/ taskname CANCELLED DUE TO 
TERMINATION OF VTAM 


If hex 41 is set, message 5J971 is issued: 


5J971 VTAM CANCELLED FOR INVALID 
CONDITION function code 
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Function Codes 


The two low-order bytes of register 15 are set with flags and 


a function code. The flags occupy the first four bits, and 
function code occupies the remaining 12 bits. The func- 
tion codes are listed below: 


Function 
Code (hex) 


7001 


7005 


7071 
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Issuing 
Module 


ISTOCCSM 
ISTAPCUE 


ISTAPCUE 


ISTORCRT 


Reason 


The address of an appli- 
cation program’s RPL or 
ECB is invalid. 


ACF/VTAM was unable 
to restore its registers 
after a user exit routine 
returned to ACF/VTAM. 


RELSTORE was issued for 
an area of storage that was 
not originally obtained by 

REOSTORE. 











VR Status Field 


The VR STATUS field in message 1ST5371 or 5F371 may 
present the following values: 


ACTIV—the VR is active 
It has been defined to ACF/VTAM in a path definition 
set. It has been successfully activated. It is in use by a 
session(s). 


PACT —the VR is pending active 
It has been defined to ACF/VTAM in a path definition 
set and is in the process of being activated by this nade. 


PINAC—the VR pending inactive 
It has been defined to ACF/VTAM in a path definition 
set and has recently been active, but is now in the process 
of being deactivated by this node. Unless ACF/VTAM 
is halting, the VR will be automatically reactivated when 
it is again needed for a session. 


INACT—the VR is inactive 
It has been defined to ACF/VTAM in a path definition 
set, but is not currently active. It will be automatically 
activated when it is needed for a session. 


UNDEF —the VR is undefined 


It has not been defined to ACF/VTAM in a path defini- 
tion set. 
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ER Status Field 


The ER STATUS field in message IST5371 or 5F37!1 may 
present the following values: 


ACTIV1—the ER is active 
It has been defined to ACF/VTAM in a path definition 
set, is physically available to the network, and has been 
activated by the node at the other end of the route. 


ACTIV2—the ER is active 
It has been defined to ACF/VTAM in a path defini- 
tion deck, is physically available to the network, has 
been activated by the node at the other end of the route, 
and is in the process of being activated by this node. 


ACTIV3—the ER is active 
it has been defined to ACF/VTAM in a path definition 
set, is physically available to the network, and has been 
activated by this node or by both this node and the node 
at the other end of the route. 


MIGR—the ER is active (but only for limited function, 
“‘migration’’ use) 
It has been defined to ACF/VTAM in a path definition 
set and is believed to be physically available to the net- 
work. During activation processing, it was determined 
that one or more nodes along the route do not support 
the explicit route protocols. 


PACT —the ER is pending active 
It has been defined to ACF/VTAM in a path definition 
set, is physically available to the network, has not been 
activated by the node at the other end of the route, and 
is in the process of being activated by this node. 


INACT—the ER is inactive 
it has been defined to ACF/VTAM in a path definition 
set and is physically available to the network, but has 
never been successfully activated. Activation will be 
attempted automatically when the ER is needed for a 
session. 
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ER Status Field 


INOP—the ER is inoperative 
it has been defined to ACF/VTAM in a path definition 
set, but is not physically available to the network. That 
is, connectivity does not exist along the entire route. 





PDEFA—the ER is “‘pending definition—active”’ 
7 It is physically available to the network and activation 
od has been attempted by the node at the other end of 
the route, but it has not yet been defined to ACF/VTAM 
in a path definition set; it will be automatically activated 
by this node when an appropriate path definition set is 
processed. 


PDEFO—the ER is “pending definition—operative” 
It is physically available to the network, but is has not 
yet been defined to ACF/VTAM in a path definition set. 


UNDE F—the ER is undefined 


It has not been defined to ACF/VTAM in a path defini- . 
tion set and is not physically available to the network. 
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Internal Trace Record Summary 


The following lists all internal trace records alphabetically by 
record ID. For detailed descriptions of the trace records, 
refer to the ACF/VTAM Diagnosis Guide. 








L9 


C ¢€¢ ¢ 


(hex) 


a 


AUTH RPL 

TPIO Address 
(MVS 
only) 


Return 
Address 


ABEND 
RELSTORE 


Attention 
SSCP Return 

(not Address 
NCSPL (Issuer) 
or RUPE) 


*ASID (MVS), 0 (VS1), or TID (VSE) 


RPL 
Address 
(Issuer) 


PST 
Address 


NCB 
Address 


Save 
Area 
Address 





Address 


or CID na 


Flag 
Bytes 


CPCB CPCB 
Word 1 OPCODE 


Buffer 
Address 


CPCB CPCB 
Word 3 Word 4 

















stad 1—-1-—-1-1-1-1-1-1-1-—-1-—-1-1-1-—- 












































































(hex) 
> Oo- 1 2 3 4 5 6-7 8 9 A B C D—~E—-F-—-O-1—-2-—-3-—-4-5-6-—-7-—-8-9-—-A—B-—-C—O-—E-—F — 
SSCP ccl Return Save Save RUPE RU ” 
(RUPE) or & Address Q | Area Area CID 2 
cco r (Issuer) © | Address ID Oo 
SSCP CCl Return Save Save CPCB 
(NCSPL)} or Fe) Address a Area Area WTD 
cco i (Issuer) O | Address ID 
PAB DISP PST Work PAB Work Module RPH 
Dispatch Address Element | Address Element Name or » | Address 
5 Address mi Queue DVT 2 
O o Address iz 
Error : 
Recovery CUA = NCB ra Virtual NCB a w CSW 
Procedures @ | Address 2 | CAW Flags O}]2] 3 
(Byte 3=06, 2 s = OF hare 
07, or FE) F 5 wl fle|l ols 
Error a CCBCPAD NCB a S = 
Recovery = E|= w | Flags » | vo ® n ® He Wel Ya } 
Procedures > ivi = ee & Zc , Zal Zz Tey zo ae < Bs z = eG 
ee 2 em = =a leg on Og Gel G9 $ | 98 | 98 [Be] 38 $ 
P;o/o02 |<} a] ala]2 o> as)a> | 25 | @s es 2s 5 
F/Fl] 25 ;r/r}r}r]e “ao pol, a wu 2 wu 2 jo} wy @ = 
Error S NCB ve Q 
Recovery ny e Flags pe 5 
Procedures - 2 * a 
(Byte 3=OA)s glo] og ° O a 





*ASID (MVS), 0 (VS1}, or TID (VSE) 
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Byte 
(hex) 


TPESC 


TPEXIT 


FREEBLK 


FREESTOR 


Return 
Address 
(Issuer) 


Return 
Address 
(Issuer) 


Return 
Address 
(Issuer) 


Return 
Address 
(Issuer) 


*ASID' (MVS), 0 (VS1), or TID (VSE) 


DISP 
Address 


PST 
Address 


Storage Address 
Address of 
SPANC 


Storage Subpool 
Address Number 


Element 


Work 
Element 
Queue 


Length of 


Storage 
Freed 


Length of 


Storage 
Freed 


Module 
Name or 
DVT 
Address 


Caller of 


Utility 





~ 


Byte 
(hex) 


GETBLK 





GETSTOR 


INTERRUPT 
(Byte 3=06, 
07, or FE) 


INTERRUPT 
(Byte 3=09) 


INTERRUPT 
(Byte 3=0A) 


TPIO 








{She tata 1S fPaat S Seeteat, She 1S 
§242 9924 28 4627-89 - A286 =D S68 =F =0 —1-2439-—4 = 5-6-7=68 -=-9-A=B=-C=—D=—E—F= 














































GBLK Return Storage Address | Length of Return Calier of 
Address Address Storage Code Utility 
(Issuer) Request or O 
















Subpool 
Number 






GET Length of 


Request 


Storage 
Address 


NBC 
Address 


Return 


Module 
Reserved 


Return 
Address 
(Issuer) 


Oo 
‘°) 
Qo. 
ce) 


Ss) 














a 


3 
ra 
a 
& 
va 
INT NBC O | Virtual Flag 
CUA Address ST CAW Bytes o CSW 
O fo] 
wT rs) 
NT 2 rr oO xei¥xiof2 uy a 
ora ee CCW Q jo] pu [Nce wilt D/S/OlS5},/21 2 
S| | Address | 8 [415 | ot | Fleas QO] 4 Q1Slelslcjal] x 
aati} ses LCioli<t]o 29] 5 zZzIiZz/lszI1O/4e%]0]7 w 
SZ s afaji}s Bg < alalstS[S(S]| 3 
Z2>] Oo SIS(S [5 Oo| =x BIHTS LalLaLalT oa 
< jcw |alslale w| 2 OSS aclFlS|oIe 
T F Address mT wy Oly O/a1S]o/2/5]S]5 
ot | & D PA 5a19 Zi aIBlalslslale 
2z22i 0 co m1 oo OO} a Oo} ODinignininoi Dia 
RU 












> RPL wm | Return NIB ale|l an 

= Address | © | Address Address of lz} a | z| com OPTC2 OPTC3 
Ww x< | (Issuer) or CID Liloelt]| & |Z] troiCD 

fe VT) Clwoi>| > 





“ASID (MVS), 0 (VS1), TID (VSE) 


































































Byte 
(hex) ne —1—1—1-—1 — 

ee 0—1—2—3—4—5—6—7—8-—9—A—B—C—D—E-—F—0—1—2-—3—4—5-—6—7—8-—9-—A— B—C—D 

IRB IRBD PST Sync PST Sync IRB 

DISPATCH ae TPPSTed Normal Address ee O 
Queue Queue rT! 
(STPP) (SNRM) 

IRB IRBX TCB TCB ASCB ASCB RB 

EXIT Res New Old New Old Address 
Address Address Address**| Address** 

TPLOCK LKEX Return PST CRA- Lock Lock Lock RPH 

EXCLUSIV Address Address LKACT Address Level Word Address 

TPLOCK LKSH PST CRA- Lock Lock Lock RPH 

SHARED Address LKACT Address Level Word Address 


*ASID (MVS), 0 (VS1), or TID (VSE) 
**Zero in VS1 


~ 
=k 


Lost 
Trace 
Record 


TPMSG 


Internal 
Request or 
Response 
PIU 


FID4 
PIU 
(part 1) 





Blanks 

























Return Message Save Module Variable Data 
Address ID Area 
(Issuer) Address 





: Heep - 
TSCB 24 Bytes of PIU 





*ASID (MVS), 0 (VS1), or TID (VSE) 
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c¢ ¢ 


Byte 
(hex) 

eee eT 

FID4 

PIU 

(part 2) 

TPPOST Return 
Address 
(Issuer) 

TPQUE Return 
Address 
(issuer) 

QUEUED 

REQSTORE 


*ASID (MVS), 0 (VS1), or TID (VSE) 


PST 
Address 


PST 
Address 


PST 
Address 


28 More Bytes of PIU 


PAB 
Address 


PAB 
Address 


Buffer 
Address 


Address 


Work 
Element 
Address 


DVT 
Address 


Module 
Name or 
DVT 
Address 


RPH 
Address 


RPH 
Address 





rs Byte 
(hex) 


eee cad 
RPL RPL EXIT RPL 
EXIT Address Address Area 
RELSTORE Return PST Buffer Register 
Address Address | Address Buffer 
(Issuer) or O Address 


REQSTORE Return PST Buffer Register | No.of |Retn 
Address Address | Address 1 
(Issuer) or O 





RESUME PST Work PAB Work 
Address Element Address | Element 
Address Queue 





*ASID (MVS), 0 (VS1), or TID (VSE) 








( 


( ; 





Byte 
(hex) —~1—1-1-1-1 —1-1-1-1—-1-1-1-1 —1-1-1- 
0—-1-2-3-4 +5-6—7-8 =9—A=8-—C=0-—E=F —0=142=3+4 =5-6-7-8 —9=A—B=C=D-=E-F= 
TPSCHED Return PST PAB Work Module 
Address Address Address Element Name or 
(Issuer) Qa Queue DVT 
oo Address 
START 1/0 CUA NCB CAW NCB Module Device-Dependent 
(Byte 3=06, Address Flags ID Information 
07, or FE) 
WW NCB 
START 1/0 s Slal- NCB 
(Byte 3=09) < |5/2/2/2]s]8] caw Flags ° . 
2 wWwivYyiDdal/olal& = CCW Operation Codes 
=) eFlofialwli[uw|e? re) 
8 }2/2/2/5|5/2 z 
z rijxrixriasasr i 
wi NCB 
START 1/0 Ss Ss > ew ¥ ” 
(Byte 3=OA) < B a n” a 3 CAW -Icla| ® oladi/< < = o| 2 
2 O7;4e/uyelru yu a/>|wl/ >lolaja; aye < 
5 wli¥l/ol;lrOolol]o miWlia | Wl Al ai|o|] a ][ 4/9 =| 
mo rFy,Ho! O;/O;a fu H/QO;0}/ OF = alae] + |} tp aeypoyu 
8 (21g/sllelg $3121 8/2/812| 8 |glsial 2 
2 m oS o;jaliala 2 oo; Xa oi ala] Oo | oOo]; aio] a 
32 or 64 Bytes of SNAP Data 
SRB PST PST TCB 
DISPATCH Async. Async. 
(MVS only) Dispatch Nondisp. 


Queue Queue 
(ADSP) (ANDSP) 





~ 
O1 *ASID (MVS), 0 (VS1), or TID (VSE) 


~J 
Oo 


Byte 


(hex) 
ee 
SRB PST ASCB ASCB 
EXIT Async. New Old 
(MVS Dispatch Address Address 
only) Queue 

(ADSP) 

User Exit Type Primary Secondary LU Name 
Exit Dependent (APPL) LU Name (EXC. TPEND) 


User Exit Exit CID 

(DFASY Address | or O 

& RESP) 

TPUNLOCK Return PST CRA- RPH 

ALL Address Address LKACT Address 
(Issuer) 





*ASID (MVS), 0 (VS1), or TID (VSE) 








LL 


C ¢ 


(hex) 


ed 


TPUNLOCK 
User 

Post 
VTALLOC 
VTFREE 


WAIT 


*ASID (MVS) or 0 (VS1) 


Return 
Address 
(Issuer) 


RPL 
Address 
(Issuer) 


Return 
Address 
(Issuer) 


Return 
Address 
(Issuer) 


Return 
Address 
(Issuer) 


PST 
Address 


ECB 
Address 


Storage 
Address 


Storage 
Address 


O PST 
Address 


CRA- 
LKACT 
CID 

or O 


Subpool 
Number 


Subpool 
Number 


PAB 
Address 


Lock Lock 

Address Level 
RPL RPL 
Area RLEN 


Length of | Return 
Storage Code of Utility 
Request 


Length of Caller of 
Storage Utility 
Freed 


Work PAB DVT 
Element Chain Address 
Queue Field 





RPH 
Address 


Coding Conventions 


PART 2. INSTALLATION 
Coding Conventions 
Conventions used to explain the syntax of macro instruc- 


tions and definition statements, and the rules used to code 
them are summarized here as assembler language rules. 








Name Operation Operands 
Symbolic Macro instruction Required and optional 
name or statement operands 





The Name field symbolically identifies the macro instruc- 
tion, definition statement, or minor node. If asymbolic 
name is specified in the field, it must contain 1 to 8 char- 
acters in the following format: 





first character — alphabetic (A-Z) or the national 
characters @, #, or $ 


second through — alphanumeric (A-Z or 0-9) or the national 
eighth character characters @, #, or $ 


The name must begin in the first position of the macro 
instruction or statement and must be followed by one or 
more blanks. If the description indicates that the name is 
optional, you may still want to code it, since ACF/VTAM 
uses it in operator messages referring to the resource defined. 


The Operation field identifies the macro instruction or state- 
ment. It must be preceded and followed by one or more blanks. 


The Operands field contains operands coded in any order 
and separated by commas. The Operands field ends with 

one or more blanks placed after the last operand. In most 
macro instructions or statements, keyword operands are used 
in the Operands field. Keyword operands are followed by an 
equal sign (=) and the keyword value. The keyword value 
can be a single value or a list of values. If it is a list of values, 
the values must be separated by commas and the list must be 
enclosed in parentheses. 
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Coding Conventions 


Comments can be written after the Operands field, but they 
must be separated from the last operand of the Operands field 
by one or more blanks. An entire card can be used for a com- 
ment by placing an asterisk in the first column of the card. A 
macro instruction that has no operands cannot have comments 
on the same card as the operation code. 





ACF/VTAM definition statements and NCP generation macro — 
instructions are coded in columns 1 through 71 of acard. A wa 
statement or macro instruction that exceeds 71 columns can 
be continued on one or more additional cards by placing a 
nonblank character in column 72 to indicate continuation. 
The operands can be interrupted either at column 71 or after 
any comma that separates operands. The continued portion 
must begin in column 16 of the following card. Comments 
can appear on every card of a continued statement. Columns 
73 through 80 can be used to code identification characters, 
statement sequence characters, or both. 





Restrictions on Use of Assembler Features 


The NCP generation macro instructions and the ACF/VTAM 
definition statements are coded in standard operating system 
macro instruction format, as described above, with the 
following restrictions: 


Assembler program control instructions (such as ICTL, 
ISEQ) cannot be used in major node definition decks. 


Assembler listing control statements (such as PRINT, rd 
SPACE, EJECT) can be used in the NCP generation deck 

but must not be used in definition decks for the other 

types of major nodes. 


Some assembler features must not be used in a major node 
definition deck: 





User assembler macro instructions that generate NCP 
macro instructions are not permitted. 


Names generated by global variables (for example, 
&SYSNDX or &SYSECT) cannot be used. 


Variable substitution at assembly time is not permitted. 
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Coding Conventions 


References to assembler attributes (length, type, etc.) 
are not permitted. 


Use of literals is not permitted. 


Quoted strings cannot be used to make names out of key- 
words. For example, AUTH="PASS”’ is treated just like 
AUTH=PASS. 


Null keywords cannot be used. For example, ‘’, ,”’ is 
treated as a null keyword and is invalid. 


Comments, statements, or remarks can be used in decks for 
all types of major nodes. 


Errors made in the major node definition decks filed in the 
ACF/VTAM definition library result in messages to the 
system operator’s console during ACF/VTAM initialization 
or VARY ACT command processing. 


Missing continuation characters can cause the NCP (during 
NCP generation) to assume values that are not physically 
correct (for example, half-duplex lines instead of full-duplex 
lines). 


Macro Instructions and Definition Statements 


Conventions used to illustrate the format and coding of mac- 
ro instructions and definition statements are as follows: 


Capital Letters: Capital letters represent values that are 
coded directly, without change. Brackets [ ], ‘‘or’”’ bar |, 
underlines, and superscripts are never coded. 


Lowercase Letters: Lowercase letters represent operands for 
which a value or name must be supplied if the operand is 
coded. 


Brackets []: Brackets enclose operands or symbols that are 
either optional or conditional. Conversely, the lack of brack- 
ets indicates that an item or group of items must be coded. 
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Coding Conventions 


An optional operand is one that can be coded or omitted in- 
dependently of other operands that are coded or omitted. 
Depending on the operand, omitting it might cause the cor- 
responding feature or function to be omitted or included, 

or omitting it can cause a specific value (the default value) to 
be assigned. When the syntax of a macro instruction or state- 
ment is shown in this book, any operands that are always re- 
quired appear first, followed by the optional or conditional 
operands in alphabetical order. 


Vertical ‘‘or’’ Bar (|): A vertical bar between operands indi- 
cates that one operand must be coded from among the values 
separated by the “’or”’ bar. 


Parentheses, Equal Sign, and Commas: Parentheses, equal 
signs, and commas are coded as shown. 


Underlined Values: An underlined value represents the value 
that ACF/VTAM or the NCP uses if the operand is omitted 
(the default value). 


Braces { \; Braces indicate mutually exclusive operands. 
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Defining: Application Program @ Local Non-SNA 


Defining the Network 
Application Program Major Nodes 


For an application program major node, code one VBUILD 
statement and then one APPL statement for each application 
program. 


[name] VBUILD TYPE=APPL 


name APPL  [,ACBNAME=acbname] 
[, AUTH=(|ACQ|NOACQ] 
[,CNM|NOCNM] 
[,PASSINOPASS] 
[,PPO|SPO|NOPO] 
[,TSO|INOTSO]! 
[,VPACE|INVPACE] )] 
[, AUTHEXIT=YES|NO]? 
[, DLOGMOD=default logon mode entry 
name] 
[,EAS=n|404] 
[,ENCR=SEL|REQD|OPTINONE] ? 
[MAXPVT=nI0] * 
[,.MODETAB=logon mode table name] 
[ ,PARSESS=YES|NO] 
[,PRTCT=password ] 
[,SONSCIP=YES|NO] 
[,SPAN=name] ° 
[, SRBEXIT=YESINO]! 
[, VPACING=n|0] 
[,VTAMFRR=YESINO]! 
[,SSCPF M=USSNOP|USSPOI] 
[, USSTAB=name] 
[, VPACING=nI0] 
[, VTAMFRR=YESINO]? 
Local Non-SNA Major Nodes 
Code one LBUILD statement for each set (major node) 
of channel-attached non-SNA terminals. 


[name] LBUILD [,CONFGDS=name] 
[,CONFGPW=password] 





1 Applies to MVS only. 

2 Applies to OS/VS1 only. 

3 Applies to the Encrypt/Decrypt Feature only. 

* Applies to OS/VS only. 

5 Applies to NCCF only. 33 
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Defining: Local Non-SNA @ Local SNA 


Code one LOCAL statement for each channel-attached non- 
SNA terminal (minor node) in the major node. 


name LOCAL CUADDR=channel device name 
[, TERM=3277|3284 (3286 ] 
[,DLOGMOD=default logon mode entry 
name] 

[ FEATUR2=([EDATSINOEDATS] 
[MODEL1|MODEL2]}) 

LISTATUS=ACTIVEIINACTIVE] 

[,_LOGAPPL=application program name] 

[,_OGTAB=interpret table name] 

[, MODETAB=logon mode table name] 

[,SPAN=name] ! | 

[, USSTAB=USS definition table name] a" ] 


Local SNA Major Nodes 








Code one VBUILD statement for each set of channel- 
attached SNA devices. 


[name] VBUILD TYPE=LOCAL 
[,CONFGDS=name] 
[,CONFGPW=password] 

Code one PU statement for each physical unit in the local 

SNA major mode. 


name PU CUADDR=channel device name 
[ ,DISCNT=([YES|NO] [,FINF] 
[,DLOGMOD=default logon mode entry name] ? 
[, ENCR=REQD/SELIOPT|INONE] 2’? a 
L.ISTATUS=ACTIVE|INACTIVE] nag? 
[,_LOGAPPL=application program name] ? 
[,LOGTAB=interpret table name] ? 
[ MAXBFRU=number|1] 
[,MODETAB=logon mode table name] ? 
[ ,PACING=n10)1] ? 
[,PUTYPE=2] 
[,SPAN=name] ! 
[,SSCPFM=FSS|USSSCS] ” 
[,USSTAB=USS definition table name] ? 
[, VPACING=n|0/1] 


1 Applies to NCCF only. er 

2 If any of these operands are specified in both the PU and LU 
statements, the values used are those in the LU statement. 

3 Applies to OS/VS only. 
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Defining: Local SNA ® Switched 


Code one LU statement for each logical unit associated with 
a physical unit within a local SNA major node. 


ee name LU LOCADDR=n 
ww [,DLOGMOD=default logmode entry] ' 
[,ENCR=REQD|SELIOPT|INONE] ?°? 
[,ISTATUS=ACTIVE|INACTIVE] 
[,LOGAPPL=application program name] ' 
| [, LOGTAB=interpret table name] ! 
ee’ [,MODETAB=logon mode table name] ' 
[,PACING=nj011] ! 
[,SPAN=name] ! °° 
[,SSCPF M=FSS|USSSCS] ! 
[, USSTAB=USS definition table name] ! 
‘Nea [,VPACING=n|011]! 


Switched Major Nodes 


Code one VBUILD statement for each switched major 
node. 


name VBUILD TYPE=SWNET 
[, MAXGRP=n] 
[, MAXNO=n] 
[,CONFGDS=name] 
[, CONF GPW=password] 


: lif any of these operands are specified in both the PU and LU 
ed statements, the values used are those in the LU statement. 

* Applies to the Encrypt/Decrypt Feature only. 

3 Applies to NCCE only. 


85 





ti 
Defining: Switched 


Code one PU statement for each physical unit in the switched 
major node. 


name PU ADDR=station address aw 
ADBLK=identification block 
ADNUM=identification number 
[,BATCH=YES|NO] 1? 
[,DISCNT=([YESINO] [,FINF] )] 
[, DLOGMOD=default logmode entry name] ! 
[, ENCR=REDO|SEL|OPT|NONE] '? 
[, FEATUR2=LOWERCSE| 

DUALCSE] 

[,JIRETRY=YES/NO] ? 
[LISTATUS=ACTIVE|INACTIVE] : 
[,LOGAPPL=application program name] ' nd 
[, LOGTAB=interpret table name] ’ 
[ MAXDATA=SIZE/261 (|265] * 
[,MAXOUT=n|1] 
[,MAXPATH=n(0] 
[.MODETAB=logon mode table name} ! 
[,PACING=nj0\1] ! 
[,PASSLIM=n(|1] ? 
[ PUTYPE=n/2] 
[,SPAN=name] * 
[,SSCPFM=FSS|USSSCS|USSNTO]! 
[, TERM=terminal type] !? 
[, USSTAB=USS definition table name] ! 
[, VPACING=nj0|2] ' 








11f any of these operands are specified in both the PU and 
LU statements, the values used are those in the LU 
statement. 

* These operands cannot be specified in either the PU or the 
LU statement for devices on lines connected through a 
communication adapter. 

3 Applies to OS/VS only. 

4 Default 261 applies to PU type 1, and default 265 applies 
to PU type 2. 

> Applies to NCCF only. 
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Defining: Switched 


Code up to 256 PATH statements to define dial-out paths 
for each physical unit. Each PATH statement must immedi- 
ately follow the PU statement that defines the associated 
physical unit. 


[name] PATH DIALNO=telephone number 
LINENM=linename 
[,GID=n] 
[,GRPNM=groupname] 
[,PID=n] 
[,REDIAL=n|3] 
[, USE=YES|NO] 


Code one LU statement for each logical unit associated 
with a physical unit within a switched major node. 


name LU LOCADDR=n 

[, BATCH=YESINO] "? 

[,DLOGMOD=default logmode entry] ! 

[,ENCR=REQD|SELIOPT|NONE] "3 

[,FEATUR2=LOWERCASE| 
DUALCSE] !? 

LISTATUS=ACTIVE|INACTIVE] 

[,LOGAPPL=application program name] ! 

[,LOGTAB=interpret table name] ! 

[,MODETAB=logon mode table name] ! 

[,PACING=n/011]? 

[, SPAN=name] 4 

[,SSCPF M=FSS|USSSCS|USSNTO]? 

[, TERM=terminal type] '? 

[, USST AB=USS definition table name] ' 

[,VPACING=n/011] ? 


‘If any of these operands are specified in both the PU and 
LU statements, the values used are those in the LU 
statement. 

* These operands cannot be specified in an LU statement 
for LUs connected through a communication adapter. 

3 Applies to the Encrypt/Decrypt Feature only. 

4 Applies to NCCF only. 
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Defining: NCP 
Network Control Program Major Nodes 


File one or more PCCU statements in front of the NCP 
generation deck. (This is a required ACF/VTAM only 
statement.) 


[symbol] PCCU ,NCPLUB=lubname' 
[, AUTODMP=YES|NO] 
[ AUTOIPL=YES|NO] 
[ AUTOSYN=YESINO] 
[,BACKUP=YES|NO] 
[,CHANCON=COND|UNCOND] 
[,CONFGDS=name] 
[,CONFGPW=password] 
{,CUADDR=channel device name] 
[, DUMPDS=dumpname] 
{, DUMPSTA=link station name] 
[,INITEST=YES|NO] 
[, LOADSTA=link station name] 
[. MAXDATAssize] 
[,OWNER=ownername] 
[,RNAME=link station name|(name, 

name, ...,name)] 

[ SUBAREA=n] 
[,.VFYLM=YES|NO] 


1 Applies to VSE only. 
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Defining: NCP 


NCP generation operands that are used by ACF/VTAM 
are as follows: 


ADDR 
ANS 
ANSWER 
ATTN 
ww AUTO 
AUTODL 
BATCH 
BHSET 
BNNSUP 
CALL 
CDATA 
CONV 
CUTYPE 
DEVICE 
DIAL 
DIALNO 
DIRECTN 
DISCNT 
DLOGMOD 


ad ENCR 





V = ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. 
- N = ACF/VTAM only; for a description, refer to ACF/ 
Ld VTAM Planning and Installation Reference. The 
Network Terminal Option Installation manual 
should be consulted for further discussion. 
R = ACF/VTAM restriction; for a description, refer to 
ACF/VTAM Planning and Installation Reference. 
wo The operand is described in ACF/NCP-SSP Instal- 
lation. 
* = Described in NCP Generation Manual (no special 
ACF/VTAM restrictions). 


89 





Defining: NCP 


NCP generation operands used by ACF/VTAM (continued) 





FEATUR2 
GPOLL 2 
IDSEQ ‘wane 
IRETRY 
ISTATUS 
LINEADD 
LINEAUT 
LNCTL 
LOCADDR 
LOGAPPL 
LOGTAB 
MAXDATA 
MAXLU 
MAXOUT 
MODETAB 
OWNER 
PACING 
PASSLIM 
PAUSE 
POLIMIT 
POLL 
POLLED 





V = ACF/VTAM only; for a description, refer to ACF / 
VTAM Planning and Installation Reference. 
N = ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. The . 
Network Terminal Option Installation manual wa 
should be consulted for further discussion. 
R = ACF/VTAM restriction; for a description, refer to 
ACF/VTAM Planning and Installation Reference. 
The operand is described in ACF/NCP-SSP Instal- 
lation. i % 
* = Described in NCP Generation Manual (no special ed 
ACF/VTAM restrictions). 
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Defining: NCP 


NCP generation operands used by ACF/VTAM (continued) 


PT3 EXEC 
PU 
PUTYPE 
SESSION 
SSCPFM 


SUBAREA 
(used by PU) 

TERM 

TGN 

TYPE 

USE 

USSTAB 

VIRTUAL 

VPACING 

X21SW 





V =ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. 

N =ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. The 
Network Terminal Option Installation manual 
should be consulted for further discussion. 

R =ACF/VTAM restriction; for a description, refer to 
ACF/VTAM Planning and Installation Reference. 
The operand is described in ACF /NCP-SSP Instal- 
lation. 

* =Described in NCP Generation Manual (no special 
ACF/VTAM restrictions). 
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Defining: NCP 
Operands in NCP Macros Used by ACF/VTAM 


ANSWER=ONI|OFF 

AUTODL=YESINO 

BHSET 

CALL=IN|IOUT|IINOUT 

DISCNT=([ YES|NO] [,F|NF] } 
DLOGMOD=default logon mode entry 
ENCR=REQD|SELIOPT|NONE (OS/VS only) 
FEATUR2=(operand,operand. . .) 


The operands are: 


EDATSINOEDATS 
LOWERCSE|DUALCSE 
MODEL1|MODEL2 


GPOLL=chars 
ISTATUS=ACTIVE|IINACTIVE 
LINEAUT=YES 

LOGAPPL=application program name 
LOGTAB=interpret table name 
MODETAB=logon mode table name 
OWNER=ownername 

PACING=n(0O|1_ 

POLIMIT=([n|1] [ WAITINOWAITIQUEUE] ) 
PU=YES|NO 

SESSION=count|1_ 
SSCPFM=ESS|USSSCS/|USS3270|USS3275|USSNTO 
TERM=type 

USE=NCPI|EP 

USSTAB=USS definition table name 
VPACING=n|0|2_ 

X21SW=YESINO 
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Defining: Dynamic Reconfiguration 


The first definition statement is VBUILD TYPE=DR. To 
code a DR member or book, use ADD and DELETE state- 
ments, each followed by NCP generation PU and LU macro 
instructions as required. The completed set of statements 
must be filed in the ACF/VTAM definition library. 


The formats of these statements are: 


[name] ADD TO=resource-name 
[name] DELETE F ROM=resource-name 
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Defining: Channel Attachment Major Nodes 


The VBUILD Statement 


Code a VBUILD statement for each set of channel attach- 
ment definition statements. 


[name] VBUILD TYPE=CA 
[, CONFGDS=name] 
[ CONF GPW=password ] 


A channel attachment major node may contain definition 
statements for channel-to-channel support (OS/VS only) 
or for communication-adapter support (VSE only). 


A channel attachment major node begins with a VBUILD 
statement, but may contain different types of link groups. 
Each link group has a unique GROUP statement and con- 
tains a unique set of minor node statements. The operands 
and default values also vary according to the particular link 
group being defined. The following list shows the structure 
of minor nodes associated with each type of link group that 
can be defined in a channel attachment major node. 


e GROUP LNCTL=CTCA (OS/VS only) 
LINE 
PU 


e GROUP LNCTL=SDLC,DIAL=NO (VSE only) 
LINE 
PU 
LU 


e GROUP LNCTL=SDLC,DIAL=YES (VSE only) 
LINE 
PU 


e GROUP LNCTL=BSC (VSE only) 
LINE 
CLUSTER 
TERMINAL 


A summary of the operands for the minor node statements 
of a channel attachment major node is provided in the 
ACF/VTAM Planning and Installation Re ference. 
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Defining: Channel Attachment Major Nodes 


The GROUP Statement for a CTCA Line Group 


The GROUP statement defines the type of links that follow 
and also carries other operands that ‘‘sift down’ to following 
statements that do not explicitly override them. 


This group statement shows the valid operands and defaults 
for aCTCA line group: 


name GROUP LNCTL=CTCA 
[ DELAY=timel0|.100] *? 
[ , ISTATUS=ACTIVE|INACTIVE] 
[, MAXBFRU=([norm/10] [ ,max| 

norm] )] ° 

[,PUTYPE=4] ! 
[,REPLYTO=time|3.0] ? 
[,SPAN=name] 4 


' These operands can be specified in either the GROUP, 
LINE, or PU statement. They are meaningful for physical 
units, and their explanations appear in the PU statement 
description. 

2 Time is in seconds. 

3 These operands can be specified in either the GROUP or 
LINE statement. They are meaningful for lines, and their 
explanations appear in the LINE statement description. 

4 Applies to NCCF only. 
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Defining: Channel Attachment Major Nodes 
The LINE Statement for a CTCA Line 


Code one LINE statement for each channel-to-channel 
adapter. The LINE statement defines to ACF/VTAM the 
characteristics of its side of the adapter. 

name LINE ADDRESS=cua] 
,DELAY=time|0|.100] '”? 
ASTATUS=ACTIVE|INACTIVE] 
WMAXBFRU=(|norm|10] [,max| 
norm] }] 

[,PUTYPE=4] 

[,SPAN=name] ? 


MAXBFRU=([norm|10] [,maxinorm] ) 


specifies the number of buffers ACF/VTAM will use when- 
ever it starts a normal channel program. 


The PU Statement for a CTCA Physical Unit 
Code one PU statement for each LINE statement. 
name PU ,DELAY=timel0|.100] ? 
ASTATUS=ACTIVE|INACTIVE] 


/PUTYPE=4] 


[ 
[ 
[ 
[, SPAN=name] * 


1 These operands can be specified in either the GROUP, 
LINE, or PU statement. They are meaningful for physical 
units, and their explanations appear in the PU statement 
description. 

2 Time is in seconds. 

3 Applies to NCCF only. 
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Defining: Channel Attachment Major Nodes 


The GROUP Statement for an SDLC Nonswitched Line 
Group 


\ This GROUP statement defines SDLC nonswitched links; it 
also carries other operands that ‘‘sift down’’ to following 
statements that do not explicitly override them. 


If a line is defined in more than one line group, only one of 
the groups can be active. 


name GROUP LNCTL=SDLC 
[,ACTIVTO=t] ! 
[,DIAL=NO] 
[, DISCNT=([YES|NO] [,FINF] )]? 
. [,DLOGMOD=default logmode entry 
ww name] 3 
[ ISTATUS=ACTIVE|INACTIVE] 
[,LOGAPPL=application program 
name] 3 
[,LOGTAB=interpret table name] ° 
[ MAX BFRU=([norm|1|2] [ ,max| 
218) )] 
[,MAXDATA=size/26 1/265] ” 
[,MAXOUT=ni1] ? 
[| MODETAB=logon mode table 
name] 3 
[,PACING=ni011] ° 
[,PASSLIM=n|maxout] ? 
: [,PAUSE=t|0.1]! 
Ld [PUTYPE=1/21415] ! 
[,REPLYTO=n\1]'! 
[RETRIES=n\7] ! 
[,SERVLIM=ni4] ! 
[,SPAN=name] (NCCF only) 
rd [,SSCPFM=FSS|USSSCS] ° 
[, USSTAB=USS definition table] 3 
[, VPACING=n\0/2] ° 


' Applies to a LINE definition statement for an SDLC non- 
; switched line. 
ed 7 Applies to a PU definition statement for aPU on an SDLC 
no nswitched line. 
3 Applies to an LU definition statement. 
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Defining: Channel Attachment Major Nodes 
The LINE Statement for an SDLC Nonswitched Line 


Code one LINE statement for each SDLC nonswitched line. 
The LINE statement defines to ACF/VTAM: 


@® The name for the line 
@ Thechannel unit address for the line 


e Certain procedural options to be used for this line 


name LINE [ADDRESS=channel unit address| 
030] 
[ ACTIVTO=t] 
[ ,DISCNT=([ YES|NO] [,FiNF] )]’ 
| DLOGMOD=default logmode 
entry name] ” 
[ ISTATUS=ACTIVE|INACTIVE] 
[, LOGAPPL=application program 
name] ? 
[,LOGTAB=interpret table name] ” 
[, MAXBFRU=([norm|1|2] [ ,max| 
218] )} 
[,MAXDATAs=size|26 1|265] ! 
[ MAXOUT=nI1] ! 
[, MODETAB=logon mode table 
name] 2 
[,PACING=n|0/1] ? 
[,PASSLIM=n|maxout] ' 
[,PAUSE=t/0.1] 
[ PUT YPE=1|2/4/5] ' 
[,REPLYTO=n|1] 
[,RETRIES=ni7] ' 
[ SERVLIM=ni4] 
[, SPAN=name] (NCCF only) 
[ SSCPFM=FSS|USSSCS] ” 
[, USSTAB=USS definition table] ? 
[, VPACING=n|0|2] ? 


' Applies to a PU definition statement fora PU onan SDLC 
nonswitched line. 
2 Applies to an LU definition statement. 
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Defining: Channel Attachment Major Nodes 
The PU Statement for a PU on an SDLC Nonswitched Line 


Code one PU statement for each physical unit with which 
ACF/VTAM will communicate over this nonswitched SDLC 
link. 


name PU ADD R=char 

[ ,DISCNT=([ YES|NO] [,FINF] )] 

{ DLOGMOD=default logmode entry 
name] ! 

LISTATUS=ACTIVE|INACTIVE] 

[,LOGAPPL=application program 
name] ! 

[,LOGT AB=interpret table name] ! 

[ MAXDATA=size|261(PU type 1)| 
265(PU type 2)] 

[,MAXOUT=ni1] 

[ MODETAB=logon mode table 
name] ! 

[,PACING=n|0|1] ' 

[, PASSLIM=n|maxout] 

[ PUTY PE=1(|2/4|5] 
[,RETRIES=n{7] 

[ SPAN=name] (NCCF only) 

[ SSCPFM=FSS|USSSCS] ' 

[| SUBAREA=n] 

[, TADDR=charsiC1] 

[ USSTAB=USS definition table] ' 

[, VPACING=n|0|2] ’ 


' Applies to LU definition statement. 
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Defining: Channel Attachment Major Nodes 


The LU Statement for an LU on an SDLC Nonswitched Line 


Code one LU statement for each logical unit associated with 
an SDLC station (physical unit type 1 or 2) attached to a 
nonswitched SDLC line. LU statements immediately follow 
the PU statement for the physical unit. 


name LU 


96.4 


LOCADDR=en 

[, DLOGMOD=default logmode entry 
name] 

[ ISTATUS=ACTIVE|INACTIVE] 

[,LOGAPPL=application program 
name] 

[,LOGTAB=interpret table name] 

[, MODETAB=logon mode table 
name] 

[ PACING=n|0|1] 

[, SPAN=name] (NCCF only) 

[ SSCPFM=FSSIUSSSCS] 

[, USSTAB=USS definition table 
name] 

[,VPACING=n\0/2] 























Defining: Channel Attachment Major Nodes 
The GROUP Statement for an SDLC Switched Line Group 


. This GROUP statement defines SDLC switched links; it also 
eae’ carries other operands that ‘‘sift down” to following state- 
ments that do not explicitly override them. 


If a line is defined in more than one line group, only one of 
the groups can be active. 


wr” name GROUP LNCTL=SDLC 

IAL=YES 

[ ACTIVTO=t] ! 

[ ANSWER=ON|OFF]! 
[,CALL=INIOUTIINOUT]! 

[ ISTATUS=ACTIVE|INACTIVE] 
[, MAXBFRU=([norm|1|2] [ ,max| 
2|8) ))? 

[ MAXLU=ni2] ? 
[,PAUSE=t|0.1] ' 
[,REPLYTO=ti1]! 

[,RETRIES=nI7] ! 

[, SERVLIM=n1/4] ! 
[,SPAN=namel (NCCF only) 


' Applies to a LINE definition statement for an SDLC 


ww switched line. 


2 Applies to a PU definition statement for aPU on an SDLC 
switched line. 
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Defining: Channel Attachment Major Nodes 
The LINE Statement for an SDLC Switched Line 


Code one LINE statement for each SDLC switched line. The - 3 
LINE statement defines to ACF/VTAM: coe 


e@ The name for the line 
e Thechannel unit address for the line 


e@ Certain procedural options to be used for this line 





name LINE [ACTIVTO=t] 
{, ADDRESS=channel unit address| 
030] 
[, ANSWER=ONIOFF] 
[, AUTO=address] —" 
[,CALL=IN|OUT|INOUT] w 
[ ,ISTATUS=ACTIVE|INACTIVE] 
[, MAX BFRU= ([norm|1] [,max|2] )] 
[,MAXLU=n|2] ' 
[,PAUSE=t|0.1] 
[,REPLYTO=t/1] 
[, RETRIES=n|7] 
[,SERVLIM=n/4] 
[,SPAN=name] (NCCF only) 








' Applies to a PU definition statement for aPU on an SDLC 
switched line. 
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Defining: Channel Attachment Major Nodes 


The PU Statement for a PU on an SDLC Switched Line 


é Code one PU statement for each physical unit with which 
Ne’ ACF/VTAM will communicate over this switched SDLC 


link, 
name PU [ISTATUS=ACTIVE|INACTIVE] 
[ MAXLU=n/2] 
ey’ [, SPAN=name] (NCCF only) 
ed 
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Defining: Channel Attachment Major Nodes 
The GROUP Statement for a BSC Line Group 
This GROUP statement defines a BSC line; it also carries 


other operands that ‘’sift down’’ to following statements 
that do not explicitly override them. 





If a line is defined in more than one line group, only one of 
the groups can be active. 


name GROUP LNCTL=BSC 
[,CUTYPE=3271(|3275] ' 
[, DLOGMOD=default logmode 
entry name] ? 
[ FEATUR2=({[MODEL1|MODEL2] 
[.PRINTRINPRINTR] )] ? 
[LISTATUS=ACTIVE|INACTIVE] 
[,_LOGAPPL=application program 
name] ” 
[, _LOGTAB=interpret table name] 2 
[ MODETAB=logon mode table 
name] ? 
RETRIES=ni7] 3 








, 


[ 
[, SERVLIM=ni4] 

[ SPAN=namel] (NCCF only) 

[, TERM=3275|3277|3284/3286] ? 
[ USSTAB=USS definition table] ? 











1 Applies to a CLUSTER definition statement. 
* Applies to a TERMINAL definition statement. 
3 Applies to a LINE definition statement for a BSC line. 
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Defining: Channel Attachment Major Nodes 
The LINE Statement for a BSC Nonswitched Line 


2 Code one LINE statement for each BSC nonswitched line. 
‘ea’ The LINE statement defines to ACF/VTAM: 


@ The name for the line 
e Thechannel unit address for the line 


e Certain procedural options to be used for this line. 
w name LINE {ADDRESS=channel unit address| 
030] 
[ CUT Y PE=3271|3275] ' 
{, DLOGMOD=default logmode entry 
ae name] ? 
ed [, FEATUR2=([MODEL1|MODEL2] 
[,PRINTRINPRINTR] )] ? 
[ ISTATUS=ACTIVE|INACTIVE] 
[, LOGAPPL=application program 
name] ? 
{, LOGTAB=interpret table name] ? 
[, MODETAB=logon mode table 
name] ? 
[,RETRIES=n17] 
[,SERVLIM=ni/4] 
[, SPAN=name] (NCCF only) 
[ ,TERM=3275/327 71328413286] ? 
[,USSTAB=USS definition table] ? 


' Applies to a CLUSTER definition statement. 
* Applies to a TERMINAL definition statement. 
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Defining: Channel Attachment Major Nodes 
The CLUSTER Definition Statement for a BSC Cluster 


Controller 


Code one CLUSTER definition statement for each 3270 
cluster controller on the line. 


name CLUSTER 


GPOLL=char 

[, CUT Y PE=3271|3275] 

[, DLOGMOD=default logmode 
entry name] ! 

[ FEATUR2=({MODEL1|MODEL2] 
[,PRINTR|INPRINTR] )]! 

[ ISTATUS=ACTIVE|INACTIVE] 

[,LOGAPPL=application program 
name]! 

[, LOGTAB=interpret table name] ’ 

[ MODETAB=logon mode table 
name] ! 

[, SPAN=name] (NCCF only) 

[, TERM=3275|3277|3284|3286] ' 

[ USSTAB=USS definition table] ! 


' Applies to TERMINAL definition statement. 
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Defining: Channel Attachment Major Nodes 
The TERMINAL Definition Statement for a BSC Terminal 


Code one TERMINAL statement for each BSC terminal 
attached to a 3270 cluster controller. 


A printer attached to a 3275 is defined by coding the 
FEATUR2=PRINTR operand in the TERMINAL state- 
ment definition statement for the 3275, and not by coding 
a separate TERMINAL statement for the printer. 


name TERMINAL ADDRé=char 

»TERM=3275|3277|3284|3286 

[ DLOGMOD=default logmode 
entry name] 

[,.FEATUR2=([MODEL1|MODEL2] 
[,PRINTRINOPRINTR] )] 

[ ISTATUS=ACTIVE|INACTIVE] 

[,_LOGAPPL=application program 
name] 

[,LOGTAB=interpret table name] 

[, MODETAB=logon mode table 
name] 

[, SPAN=name] (NCCF only) 

[ USSTAB=USS definition table 
name] 
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Defining: CDRM @ CDRSC 


Cross-Domain Resource Manager (CDRM) Major Nodes 


Code a VBUILD statement for each set of CDRM definition 
statements. 





[name] VBUILD TYPE=CDRM 
[,CONFGDS=name] 
[,CONFGPW=password ] 


Code one or more CDRM definition statements to define 
CDRM minor nodes. 


cdrmname CDRM SUBAREA=n 
[,CDRDYN=YES|NO] 2 
[,CDRSC=OPT|REQ] ed 
[,ELEMENT=n)1] 
[ ISTATUS=ACTIVE|INACTIVE] 
[, VPACING=n|0/63] 


Cross-Domain Resource (CDRSC) Major Nodes 


Code a VBUILD statement for each set of CDRSC definition 
statements. 


[name] VBUILD TYPE=CDRSC 
[,CONFGDS=name] 
[,.CONFGPW=password] 


Code one or more CDRSC definition statements to define \ y iy 
CDRSC minor nodes. 


cdrscname CDRSC CDRM=cdrmname 
[ ISTATUS=ACTIVE|INACTIVE] 
[,SPAN=name] ! 








1 Applies to NCCF only. 
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Defining: Cross-Domain Path 


Cross-Domain Path Tables 


Code one or more PATH statements to define a path 
definition set to represent the routes ACF/VTAM takes to 
communicate with other subarea nodes. 


symbol PATH! DESTSA=n\(n1,n2,n3, ... ) 
[,ERO=(adjsub[,tg#] )] 
[,ER1=(adjsub[,tg#] )] 


[,ER7=(adjsub[,tg#] )] 
[,VRO=er#] 
[,VR1=er#] 


[,VR7=er#] 


1 Refer to the Planning and Installation Reference for details 
about specifying ER and VR. 
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TSO/VTAM Requirements 


An APPL definition statement defines an application 
program to ACF/VTAM. Because TCAS and each TSO user 
are ACF/VTAM application programs, APPL definition 
statements must be specified for them and put into 
SYS1.VTAMLST. 


Code the following APPL statements for TCAS: 


TSO APPL PRTCT=password! ,AUTH= 
(NOACQ,PASS,NVPACE,TSO, 
NOPO),EAS=1 


Code as many APPL statements, in the following format, as 
there will be users logged on to TSO/VTAM at one time: 


TSOnnnn?—- APPL PRTCT=password! ,AUTH= 
(NOACQ,PASS,NVPACE,TSO, 
NOPO),EAS=1 
Multiple-Domain Network 


TCAS and the terminals are defined with special statements. 


Code the following CDRM statements in each domain? : 


name1 CDRM CDRDYN=YES,CDRSC=OPT,... 
name2 CDRM CDRDYN=YES,CDRSC=OPT,... 


1The same password must be specified for TCAS and each 
TSO/VTAM user. 

2 A different application program name, in the form 
TSOnnnn, must be specified for each session. The suffix 
nnnn is a decimal number; the numbering must start with 
0001 and must be sequential. Note that NOACQ and 
NOPO need not be coded; they are default values. 

3 This is to avoid defining both the SLUs that log on to 
TSO/VTAM as CDRSCs in the TSO/VTAM domain, and 
the TSO user application programs as CORSCs in the 
SLU’s domain. This is controlled by the CORDYN and 
CDRSC operands. 
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TSO/VTAM Requirements 


Code the following APPL statement for TCAS in your 
domain: 


tsoa! APPL ACBNAME=TSO, 
PRTCT=password, 
AUTH=(NOACO,PASS, 
NOVPACE,TSO,NOPO), 
EAS=1 


Code as many APPL statements in the following format as 
the maximum number of sessions that will be established 
with TSO/VTAM in your domain at one time: 


tsoannnn?!:? APPL ACBNAME=TSOnnnn, 
PRTCT=password, 
AUTH=(NOACO,PASS, 
NVPACE,TSO,NOPO), 
EAS=1 


Code the following statement for each TCAS in another 
domain with which an LU in your domain will 
communicate: 


tsob°? CDRSC CDRM=name of ACF/VTAM 
manager for tsob 


‘ tsoa is a unique prefix that must be included on all APPL 
statements for your domain. The name, tsoa, must be 
unique in the network. The same prefix (that is, tsoa) 
must be specified when coding APPL statements for each 
terminal logged on to the TSO/VTAM in this ACF/VTAM 
host concurrently. 

* The nnnn suffix is a decimal integer that must start with 
0001 and be sequential. The remaining operands are 
described above. 

3 tsob specifies the name of the TCAS APPL definition 
statement in the domain of the indicated CDRM that this 
CDRSC represents. 
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If dynamic cross-domain resource definition is not author- 
ized, code the following CDRSC statements in each domain 
that contains an SLU that can communicate with your 
domain: 


tsobnnnn’? CDRSC CDRM=name of ACF/VTAM 
manager for tsobnnnn 
application 


and code a CDRSC statement in the domain of TSO/VTAM 
for each cross-domain SLU that can log on to TSO/VTAM. 


' tsob specifies the name of the TSO user APPL definition 
statement in the domain of the indicated CDRM that this 
CDORSC represents. 

2 The nnnn suffix is a decimal integer that must start with 
0001 and be sequential. The remaining operands are 
described above. 
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TSO/VTAM Requirements 


Specifying 3270 Characteristics 


Two types of 3270 devices are supported by TSO/VTAM: 
non-SNA devices attached over a channel or through a 
bisynchronous line protocol, and SNA devices attached 
by SDLC links. For non-SNA devices with a screen size 
larger than 24 X 80, or multiple screen sizes, or special 
features, and for SNA devices (LU2), you must provide a 
logmode table entry. 


Use the MODETAB and MODEENT macros to define the 
logmode table and its entry. The PSERVIC parameter 

of the MODEENT macro carries the screen sizes in row/ 
column form. If no logmode table entry exists for a 3270 
device, TSO/VTAM assumes it is non-SNA (LUO), and the 
buffer size specified by the SCRSIZE parameter of the 
TSOKEYOO member of PARMLIB (either 480 (12 X 40) 
or 1920 (24 X 80)). 


MODEENT Macro Instruction for Non-SNA 3270 Devices 


[name] MODEENT LOGMODE=name, 
FMPROF=X’'02’, 
TSPROF=X’‘02’, 
PRIPROT=X’71', 
SECPROT=X'40’, 
COMPROT=X’2000’, 


PSERVIC=X’.......... hed 
For example: 


Code the following MODEENT macro instruction for a 3270 
terminal having a screen size of 1920 characters: 


MODEENT? FMPROF=X’02’, TSPROF=X'02’, 
PRIPROT=X’71',SECPROT=X’40’, 
COMPROT=X’2000’ ,COS=cos name,? 
PSERVIC=X’000000000000000000000200’ 


1The FMPROF, TSPROF, PRIPROT, SECPROT, and 
COMPROT values are the same as those used in the IBM- 
supplied logon mode table, ISTINCLM. 

2See ‘‘PSERVIC Operand of the MODENT Macro Instruc- 
tion.” 

3 Is the name of an entry in the COS table. 
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MODEENT Macro Instruction for SNA 3270 Devices 


[name] MODEENT  LOGMODE=name, 
FMPROF=xX’03’, 
TSPROF=X'03’, 
PRIPROT=X’‘B1', 
SECPROT=X’'90’, 
COMPROT=X’3080’, 
RUSIZES=X’'8587’, 
COS=cos name,’ 
PSERVIC=X’.......... o 








The RUSIZES parameter above indicates a 256-byte maxi- 
mum secondary logical unit RU send size and a 1024-byte 
maximum primary logical unit RU send size. 





For example: 


Code the following MODEENT macro instruction for a 3270 
terminal having a primary buffer size of 1920 characters, and 
an alternate buffer size of 3440 characters: 


MODEENT FMPROF=X’'03’,TSPROF=X’'03’, 
PRIPROT=X’B1',SECPROT=X’90’, 
CMPROT=X’3080’, RUSIZES=X'8587', 
COS=cos name,” 
PSERV1C=X’02000000000018502B507F’ 











1See “PSERVIC Operand of the MODENT Macro Instruc- 
tion.” 
2 Is the name of an entry in the COS table. 
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PSERVIC Operand of the MODEENT Macro Instruction 


Code the 12 bytes of device-specific hexadecimal data of the 
PSERVIC operand as described below:!”? 


PSERVIC=xX’00. .OO0000000.......... 00’ for non-SNA 
(LUO) 
X‘02..00000000.......... 00’ for SNA 
(LU2) 
Me Ob Ri S oss Pt hate Ba Seana ‘device with- 
% out extended 
ww data stream 
capability 
Pe pO shed ee re ks Oe ee ’ device with 
extended 
data stream 
ae capability 
od > See ea eee 0000000001. .’ buffer size 
480 only 
(12X40) 
One igacre bee a hcaied 0000000002. .’ buffer size 
1920 only 
(24 X80) 
Me cite tae aye ghat OC280C507F..’ buffer sizes 
480 or 960 
(12X40) or 
12X80) 
buffer sizes 
1920 or 2560 
(24X80 or 
32X80) 
Pea een ae 18502B507F..’ for buffer 
‘ sizes 1920, 
Ld 3440 (24X80 
or 43X80) 
for buffer 
sizes 1920, 
3564 (24X80 
a, or 27X132) 


~- 


> ae ee ee 185020507F.. 


~ 


~ 


Reale tint Sarees 18501B847F. . 


1 To prevent switching of screen sizes on a device that has 
more than one size possible, code the screen size to be used 
in the primary area of PSERVIC and a X’7E’ to indicate no 
switching. For example: 


PSERVICHX cise eeatees 1B8400007E..’ for 3564 


nd buffer only 


2See ACF/VTAM Programming for details of the bit settings 
in the PSERVIC parameter, which represents bytes 13-24 of 
the session parameters. 
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_ Defining 2741, TWX, or WTTY Terminals to TSO/VTAM 





_ 2741, TWX, or WTTY devices attached to a communication 

~ controller can be used with TSO/VTAM through its LU 

type 1 protocol managers. These devices are identified to 

-» ACF/VTAM during the NCP generation process. (See 

_ Network Terminal Option Installation and the ACF /NCP-SSP 
_ Installation for details.) Since the NCP will translate ASCII 

~ line code to EBCDIC for these devices, care must be taken 

~ to ensure that any logmode entry specified by DLOGMODE 

~ and MODETAB operands on the PU or LU macro instructions 
identifies the device to ACF/VTAM as EBCDIC. An example - 3 
- is given below of an ASCII TWX logmode table entry defini- wet” 
tion that has the alternate code indicator in the COMPROT 

~ field set off (to indicate EBCDIC to TSO/VTAM). 





: The MODETAB macro instruction: 
TWXTABLE MODETAB 


The MODEENT macro instruction: 


TWXDEVIC MODEENT LOGMODE=TWXDEVIC, 
FMPROF=X’'03’, 
TSPROF=X’'03’, 
PRIPROT=X‘B1', 
SECPROT=xX’90', 
COMPROT=X'3040', 





For planning details on the use of the MODETAB and 
MODEENT macro instructions and information on coding 
these macros, see ACF/VTAM Planning and Installation 
Reference. 


104 


TSO/VTAM Requirements 


Security Considerations 


Use the CONFTXT parameter of the TSOKEYxx member 
of PARMLIB to specify whether data can be traced by 
VTAM IO or BUF type traces for a TSO/VTAM session. 
Specify CONFTXT=YES to indicate that the data is con- 
fidential, and not traceable, or CONFTXT=NO to allow 
tracing. 


Note: The CONFTXT parameter does not apply to the 


TSO type VTAM trace for TPUT/TPG/TGET buffers; they 
are always traceable. 
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Defining Procedures to Establish Sessions 
Class of Service (COS) Tables 


Define a COS table by specifying a COSTAB macro, one or 
more COS macros, and a COSEND macro. 


csectnam COSTAB! where csectnam=ISTSDCOS 
[name] COS VR=(vr#,tp#) 
((vr#,tp#) (vr#,tp#) 
(226) 
COSEND 


interpret Tables 


Define each interpret table by one INTAB macro followed by 
at least one LOGCHAR macro, followed by one ENDINTAB 
macro. 


[name] INTAB 
[name] LOGCHAR APPLID=(APPLICID,appiname)| 
(ROUTINE,routinename) 
[,SEQNCE="‘characters’ ] 
[name] ENDINTAB 


Logon Mode Tables 


Define, create, or modify a logon mode table by specifying a 
MODETAB macro, one or more MODEENT macros, and a 
MODEEND macro. 


[name] MODETAB 

[name] MODEENT [LOGMODE=name] 
[, TYPE=value] 
[,FMPROF=value] 
[, TSPROF=value] 
[,PRIPROT=value] 
[ SECPROT=value] 


1 The |BM-supplied default is ISTVTCOS, which is used for 
example to establish CORM-to-CDRM sessions. 


106 














Session: Logon Mode e USS Definition 


[,COMPROT=value] 
[,RUSIZES=value] 
[ PSERVIC=value] 
[, PSNDPAC=value] 
[,SRCVPAC=value] 
[, SSNDPAC=value] 
[,ENCR=value] ! 
[,COS=name] 
[name] MODEEND 


USS Definition Tables 


Create or modify USS definition tables with USSTAB, 
USSCMD, USSPARM, USSMSG, and USSEND macro 
instructions. 


[name] USSTAB [TABLE=name] 
[name] USSCMD CMD=name 
[,REP=name] 
[,FORMAT=BALIPL1] 
[name] USSPARM PARM=pniname 
[ REP=name] 
[,DEFAULT=value] 
[, VALUE=value] 
[name] USSMSG?  [MSG=n(n1,n2...)] 
[,TEXT='message text.] ° 
[, BUFF ER=bufferaddress] * 
[,OPT=option] 
[, SUPP=class] 
USSMSG*  MSGe=n\(n1,n2,...) 
[,DESC=(desc-code) | 
[, MCSFLAG=(value)] 
[,OPT=option] 
[, SUPP=class] 
[,ROUTCDE=(route-code)] 
[, TEX T='message text’ ] 


[name] USSEND 


1 Applies to the Encrypt/Decrypt Feature only. 

2 Format of USSMSG for terminal operator messages. 

3 TEXT and BUFFER are mutually exclusive. 

* Format of USSMSG for ACF/VTAM operator messages. 
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Character-Coded Requests and USS Definition Tables 


Using the IBM-supplied USS table, ACF /VTAM can accept a 
character-coded logon that has the following format: 


LOGON APPLID(name){[LOGMODE(name}] 
[DATA(user data) ] 





In this format: 





e LOGON represents the function of logging on and must 
be specified first. 


e The APPLID parameter names the application program 
with which the LU wants to establish a session. 





e The optional LOGMODE parameter indicates the entry in 
a logon mode table where the session parameters desired 
for use in the session can be found. 


e The optional DATA parameter contains data to be passed 
to the application program. 


ACF/VTAM expects to receive information in a character- 
coded logoff that has the following format: 


LOGOFF [APPLID(name)] TYPE(CONDIUNCOND]| 
FORCE) HOLD(YES/NO) 


In this format: 
e LOGOFF represents the function for logging off. 


e The APPLID parameter names the application program 
with which the LU is in session. 





@e The TYPE parameter indicates whether or not the session 
is to be terminated at the discretion of the application 
program, 





e The HOLD parameter indicates the disposition of the 
SSCP-to-PU session after the LU is no longer in session 
with the application program. 


If you want logons and logoffs entered at LUs in some other 
form, you have the following choices: 





e If the syntax of the logon and logoff commands is such 
that they can be translated to the character-coded logon 
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format in the IBM-supplied USS table (these tables use 
PL/I syntax), you can: 


— Change the IBM-supplied default USS table. The de- 
fault table must contain the desired translation of the 
logon and logoff command into the required IBM 
format. This table will be used for an LU that has not 
been associated with a specific USS table. 


— Write supplementary USS tables and associate them 
with specific LUs. These tables must contain the 
desired translation of the logon and logoff commands 
into the required IBM format. 


For example, suppose that you wanted to use a logon format 
from a previous system: 


L ACCOUNTS 


A replacement USS definition table could convert this to the 
standard USS format: 


LOGON APPLID(ACCOUNTS) LOGMODE(QUERY) 


e If the logons you want to use are such that a USS defini- 
tion table cannot be used to translate them into a format- 
ted command (for example they are not PL/I syntax), 
you can use an interpret table). 


The contents of the IBM-supplied USS table are shown in 
ACF/VTAM Planning and Installation Reference. \n chang- 
ing the 1|BM-supplied table or creating replacement or supple- 
mentary tables, you use USSTAB, USSCMD, USSPARM, 
USSMSG, and USSEND macro instructions. 


The USSTAB macro instruction indicates the beginning of a 
USS definition table. It can optionally specify the table to 
be used for character translation. 


The USSCMD macro instruction identifies a set of definition 


statements to be used to convert a user-defined command 
received from an LU. 


109 





Character Requests — USS Definition 


The USSPARM macro instruction identifies a user-defined 
keyword or positional parameter that can be coded in the 
user-defined command identified by the previous USSCMD 
definition. 


The USSMSG macro instruction allows you to tailor 
messages corresponding to different situations. The IBM- 
supplied table already contains messages for these situations, 
appropriate to most installations, but you may want to 
change the language. 


The USSEND macro instruction indicates the end of a USS 
definition table. 


To tell ACF/VTAM that a device supports character-coded 
messages and to indicate any input media control required 
by the device, specify the SSCPFM operand in the statement 
defining the device. To tell ACF/VTAM which USS table it 
should use in translating the character-coded commands from 
a particular LU, name the table in the USSTAB operand on 
the LU statement. 


IBMTEST Command 


IBMTEST allows the terminal operator to test the physical 
path between the terminal and ACF/VTAM. IBMTEST 
causes ACF/VTAM to return test data to the terminal a 
specified number of times. ACF/VTAM returns the test 
data with the prefix ‘“IBMECHO.”’ 


IBMTEST [nn/10] [,datal] 


nn|10 
specifies the number of times the test data should be 
returned to the terminal. Specify n as a decimal number 
in the range 1 through 255. If no value is specified, a 
value of 10 is used by default. 


data 
specifies the test data to be returned. Specify a character 
string Of up to 255 characters, or the maximum message 
length of the terminal, whichever is smaller. If you do 
not specify a character string, ACF/VTAM sends out and 
returns a string consisting of the letters A through Z 
followed by the decimal numbers 0 through 9. 
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ACB @ CHECK e@ CLOSE @ CLSDST 
PART 3. PROGRAMMING 
ACF/VTAM Macro Instructions 
ACB—Create an Access Method Control Block 


[symbol ] ACB AM=VTAM 
[ APPL|ID=address of application 
program's symbolic name] 

way” [,EXLST=exit list address] 
[, MACRF=LOGON|NLOGON] 
[,PARMS=(NIB=nib address) ] 
[,PARMS=([{NIB=nib address] 

[, USERF LD=user data] )] 
[, PASSWD=password address ] 


CHECK—Check Request Status 


[symbol ] CHECK RPL=rpl address 


CLOSE —Close One or More ACBs 


OS/VS only: 

[symbol] CLOSE (acb address[,,acb address] . . .) 
VSE only: 

[symbol ] CLOSE acb address[,acb address] . 


CLSDST—Terminate Sessions in which the Application 
Program Is Acting as the Primary Logical Unit 


eee’ [symbol] CLSDST RPL =rpl address 
[,rpl field name=new value] ... 


RPL fields that apply to CLSDST are: 





AAREA=address of target NIB=nib address 
a, PLU’'s symbolic name OPTCD=RELEASE|PASS 
ACB=acb address OPTCD=SYNIASY 
AREA=address of user PARMS=(THRDPTY= 
data for Initiate NOTIFYINONOTIFY) 
ARG=(register) RECLEN=length of user 
BRANCH=YES! |NO data 


eas’ eae address| INTERNAL 
EXIT=rpl exit routine address 


' Applies to MVS only. 











EXECRPL e EXLST e GENCB 


EXECRPL—Execute a Request 





[symbol] EXECRPL RPL=rpl address 
[ rpl field name=new value] ... 


All RPL fields apply to EXECRPL. 
EXLST—Create an Exit List les y 


[symbol] EXLST AM=VTAM 
[, DFASY=exit routine address] 
[,LERAD=exit routine address] 
[, LOGON=exit routine address] 
[, 
ie 





LOSTERM=exit routine address] 
NSEXIT=exit routine address] 
[,RELREQ=exit routine address] 
[,RESP=exit routine address] 
[,SCIP=exit routine address] 
[,SYNAD=exit routine address] 
[, TPEND=exit routine address] 


GENCB—Generate a Control Block 


[symbol] GENCB BLK= {ACBIEXLSTIRPLINIB} 

,AM=VTAM 

[,keyword=value] ... 

[,COPIES=quantity] 

[, WAREA=work area address, 
LENGTH=work area length] 

[,MF=list, generate, or execute form 
parameters | 





Keyword is any GENCB-supported keyword that can be used ed 
in the macro instruction corresponding to the BLK operand. waist 
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INQUIRE—Obtain Logical Unit Information or Application 
Program Status 


[symbol] INQUIRE RPL=rpl address 
[ rp! field name-new value] ... 


The setting of the specified RPL’s option code determines 
the type of INQUIRE to be performed. The option code can 
be: LOGONMSG, DEVCHAR, COUNTS, TERMS, 
APPSTAT, CIDXLATE, TOPLOGON, SESSPARM or 
SESSKEY. 


RPL fields that apply to INQUIRE are: 


ACB=acb address OPTCD=LOGONMSG| 
AREA=adaress of data area DEVCHAR|COUNTS| 
AREALEN=length of data area TERMS|APPSTAT| 
ARG=(register) CIDXLATE| 
BRANCH=YES? |NO TOPLOGON|SESSPARM| 


ECB=ecb saan RELA SESSKEY? 
EXIT=rpl exit routine address OPTCD=SYNIASY 
N1B=nib address 


INTRPRET—Interpret an Input Sequence 


[symbol] INTRPRET  RPL=rpl address 
[ ,rp| field name=new value] .. 


RPL fields that apply to INTRPRET are: 


AAREA=interpreted ARG=(register) 
data area address BRANCH=YES! |NO 
AAREALN= ECB=ecb address| INTERNAL 
interpreted data te IT=rpl exit routine address 
area length N1tB=nib address 
ACB=acb address OPTCD=SYNIASY 
AREA=input data RECLEN=input data length 


address 


iSTGLBAL—Declare and Set Macro Global Variables 
[symbol] ISTGLBAL 


1 Applies to MVS only. 


2 Applies to the Encrypt/Decrypt Feature only. 
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MODCB e NIB @ OPEN 
MODCB—Modify the Contents of Control Block Fields 


[symbol] MODCB AM=VTAM 

,ACB=acb address 
,EXLST=exit list address 
.NIB=nib address 
,RPL=rpl address 

field name=new value... 

[,MF=list, generate, or execute 

form parameters] 


NiB—Create a Node Initialization Block 


[symbol] NIB [BNDAREA=0|bind area address] 
[,ENCR=REQD|SELINONE]? 
[,EXLST=exit list address] 

[, LISTEND=YES|NO] 
[,LOGMODE=O|C’ ’|logon mode name] 
[, MODE=RECORD] 
[, NAME=name in configuration 
tables] 
[,RESPLIM=1 response limit] 
[, SDT=APPLISYSTEM] 
[,USERFLD=user data] 
PROC=([CAICSIRPLC] 
[, KEEPITRUNC] 
[,.NCONFTXTICONFTXT] 
[,.NDFASYX|DFASYX] 
[, NNEGBIND|INEGBIND] 
[ NRESPX|RESPX] 
[, NORDRESP|ORDRESP] 
[ SYSRESP|APPLRESP] ) | 





OPEN—Open One or More ACBs 


OS/VS only: 
[symbol] OPEN _ (acb address [,,acb address] ... ) 
VSE only: 


[symbol ] OPEN acb address [,acb address] ... 


1 Applies to the Encrypt/Decrypt Feature only. 
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OPNDST e OPNSEC @ RCVCMD 


OPNDST—Establish Sessions in which the Application 
Program Will Act as the Primary Logical Unit 


[symbol] OPNDST RPL=rpl address 
[ rpl field name=new value] . 


RPL fields that apply to OPNDST are: 
AAREA=input area address for OPTCD=ACQUIRE| 


negotiable bind response ACCEPT 
AAREALN:=length of input area OPTCD=CONANY| 
ACB=acb address CONALL 
BRANCH=YES! |NO OPTCD=CS|CA 


ee Bisa OPTCD=Q|NQ 
EXIT=rpl exit routine address OPTCD=SPECIANY 
N1B=nib address OPTCD=SYNIASY 


OPNSEC—Establish a Session in which the Application 
Program Will Act as the Secondary Logical Unit 


[symbol] OPNSEC RPL=rpl address 
[.rpl field name=new value] ... 
RPL fields that apply to OPNSEC are: 


ACB =acb address N1IB=nib address 

BRANCH=YES! |NO OPTCD=CSICA 

ECB=ecb address|INTERNAL OPTCD=SYNIASY 
EXIT=exit routine address 


RCVCMD—Receive a Message from ACF/VTAM 


[symbol ] RCVCMD RPL=rpl address 
[,rpl field name=new value] ... 


RPL fields that apply to RCVCMD are: 


ACB=acb address { ECB=ecb address| INTERNAL 
AREA=input message EXIT=rpl exit routine ae 
address OPTCD=Q|NQ 
AREALEN=length of OPTCD=SYN\ASY 
message area OPTCD=TRUNC 


BRANCH=YESI|NO 


1 ° 
Applies to MVS only. 115 








RECEIVE @ REQSESS e RESETSR 


RECEIVE—Receive Input on a Session 


[symbol ] RECEIVE  RPL=rpl address 
[,rp! field name=new value] ... 


RPL fields that apply to RECEIVE are: 


ACB=acb address OPTCD=Q|NQ 
AREA#=input data area OPTCD=SPEC|ANY 
address OPTCD=SYN|ASY 
AREALEN=length of OPTCD=TRUNC|KEEP| 
input data area NIBTK 
ARG= (register) RTYPE=(DFSYN| 
BRANCH=YES! |NO NDFSYN,DFASY| 
ECB=ecb address|INTERNAL NDFASY,RESP| 
EXIT=rpl exit routine address NRESP) 
OPTCD=CA|CS 


REQSESS-—Initiate a Session in which the Application 
Program Wil! Act as the Secondary Logical Unit 


[symbol ] REQSESS RPL=rpl address 
[.rpl field name=new value] . 


RPL fields that apply to REQSESS are: 


AAREA=0 N1IB=nib address 

ACB=acb address OPTCD=NQ 

ARE A=address of user data OPTCD=SYNIASY 
for Initiate RECLEN#=user data 

BRANCH=YES? |NO length 


Teens seen 
EX1iT=rpl exit routine address 


RESETSR—Cancel RECEIVE Operations and Switch a 
Session’s CS-CA Mode 


[symbol] RESETSR  RPL=rpl address 
[,rp| field name=new value] ... 


1 Applies to MVS only. 
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RESETSR e RPL 


RPL fields that apply to RESETSR are: 


; ACB=acb address OPTCD=CAICS 
re’ ARG= (register) OPTCD=SYN|ASY 
BRANCH=YES! |NO RTYPE=(DFSYNINDFSYN, 


{ ECB=ecb address|INTERNAL DFASYINDFASY, 
EX1IT=rpl exit routine address RESPINRESP) 


RPL—Create a Request Parameter List 


[symbol ] RPL AM=VTAM 

[, AAREA=alternate data area address] 
[ AAREALN=alternate data area length] 
[,ACB=acb address] 

: [, AREA=data area address] 

_ [ AREALEN=data area length] 
[, BRACKET=(BBINBB,EBINEB, 

CEBINCEB)] 

[,BRANCH=YES! [NO] 
[, CHAIN=FIRSTIMIDDLE|LAST| 


ONLY] 
[.CHNGDIR=(CMD|NCMD, 
REQINREQ)] 


[ CODESEL=STANDARDIALT] 
[,CONTROL=(DATA|BID|IBIS|ICANCEL| 
CHASE|LUS/OQCIRTRIQEC|RELQ| 
RSHUTDISBI|ISHUTC|ISHUTD| 
SIGNAL|BINDICLEAR|IRQR|SDT| 
STSN/IUNBIND)] 
easy’ [,CRYPT=YES|NO] ? 
,ECB=ecb address 
,ECB=INTERNAL 
,EXIT=exit routine address 
[, IBSQAC=SETITESTSET|INVALIDI 
IGNORE|TESTPOS|TESTNEG| 
RESET] 
[, |BSQVAL=inbound sequence number] 
[,NIB=nib address] 
[,OBSQAC=SET|TESTSET|INVALID| 
IGNORE|TESTPOS|TESTNEG| 


‘ey’ RESET] 


1 Applies to MVS only. 
2 Applies to the Encrypt/Decrypt Feature only. 
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RPL—Create a Request Parameter List (continued) 


[,OBSQVAL=outbound sequence 
number 

[,PARMS=(THRDPTY=NOTIFY| 
NONOTIFY)] 

[,POST=SCHEDIRESP] 

[ RECLEN=data length] 

[,RESPOND=EX|NEX,FME|NFME, 
RRNINRRN,ORESP|NORESP)] 

[ RTYPE=(DFSYNINDFSYN, 
DFASY|INDFASY,RESP|NRESP) ] 

[ SEQNO=sequence number] ww 

[,SIGDATA=signal data] 

[| SSENSEO=O|CPM|STATE|FI/RR] 

[, SSENSMO=system sense modifier] 

[ STYPE=REQIRESP] 

[,USENSEO=user sense value] 

OPTCD = ([,ACCEPTIACQUIRE] 

[,CAICS] 

[,CONALLICONANY] 

[,COND|UNCOND] 

[,LOGONMSG|DEVCHAR| 
COUNTS|TERMS|APPSTAT| 
CIDXLATE|TOPLOGON| 
SESSPARMISESSKEY’? ] 

[,NBUFFLST|BUFFLST] 

[, NCONTCHN|CONTCHN] 

[, NFMHDR|FMHDR] 

[,NIBTK|TRUNCIKEEP] 

[, NLMPEO|LMPEO] a 

[, NUSERRH|USERRH] a 

[,Q\/NQ] 

[, QUIESCE|ISTOPISTART] 

[, RELEASE|PASS] 

[,.RELRO|INRELRQ]) 


LSPECIANY] a 
LSYNIASY] ) ot 











‘ Applies to the Encrypt/Decrypt feature only. 
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SEND e SENDCMD 


SEND-Send Output on a Session 


SEND RPL=rpl address 


[,rpl field name=new value] ... 


RPL fields that apply to SEND are: 


[symbol] 


ACB=acb address 
AREA=address of output data 
or buffer list 
ARG=(register) 
BRACKET=(BB|NBB,EB|NEB, 
CEB|NCEB) 
BRANCH=YES?|NO 
CHAIN=FIRST|MIDDLE 
LASTIONLY 
CHNGDIR=(CMDINCMD, 
REQINREQ) 
CONTROL=DATA|BID|BIS| 
CANCEL|CHASE|LUS|QC| 
RTRIQEC|RELQ|RSHUTD| 
SBIISHUTCISHUTD|SIGNAL 
CODESEL=STANDARDIALT 
CRYPT=YESI|NO! 


OPTCD=LMPEO|NLMPEO 
OPTCD=SYNIASY 
OPTCD=USERRH| 
NUSERRH 
POST=SCHEDIRESP 
RECLEN=length of out- 
put data or buffer list 
RESPOND=(EXINEX, 
FMEINFME,RRNINRRN, 
NORESPIORESP) 
RTYPE=(DFSYNINDFSYN, 
DFASY|INDFASY, 
RESP|INRESP) 
SEQNO=sequence number 
SIGDATAz=signal data 
SSENSEO=CPM| 
STATEIFIIRRIO 
SSENSMO=system sense 


aaet address|INTERNA I} 
EXIT=rpl exit routine address 
OPTCD=CA|CS 
OPTCD=BUFFLST|INBUFFLST 
OPTCD=CONTCHN|NCONTCHN 
OPTCD=FMHDRINFMHDR 


SENDCMD—Send an ACF/VTAM Operator Command to 
ACF/VTAM 


SENDCMD_ RPLe=rpl address 
[,rp! field name=new value] ... 


RPL fields that apply to SENDCMD are: 


modifier value 
STYPE=REQ|RESP 
USENSEO=user sense 
value 


[symbol] 


ACB=acb address 
AREA=command address 
BRANCH=YES?\|NO 


eee address| INTERNAL 


EXIT=rpl exit routine address 


OPTCD=SYNIASY 
RECLEN=command 
length 


* Applies to the Encrypt/Decrypt Feature only. 


* Applies to MVS only. 


119 





SESSIONC @ SETLOGON 


SESSIONC—Send a Session-Control Request or Response 


[symbol] SESSIONC RPL=rp! address 
[,rp! field name=new value]... 





RPL fields that apply to SESSIONC are: 


ACB=acb address OBSQAC=SETITESTSET| ane 
ARG=(register) INVALIDIIGNORE| nd 
BRANCH=YES'|NO RESET|TESTPOS| 
CONTROL=SDT|CLEAR| TESTNEG 

STSN|RQR|BIND OBSQV AL=outbound 
ECB=ecb address|INTERNAL sequence number ; 
EXIT=rp! exit routine OPTCD=SYNIASY ed 

address RESPOND=(EX|NEX) 
IBSQAC=SET|TESTSET| SEQNO=sequence number 

INVALIDIIGNORE| SSENSEO=system sense 

RESET|TESTPOS| value 

TESTNEG SSENSMO=system 
IBSQVAL=inbound sense modifier value 

sequence number STYPE=REQ|RESP 
NIB=nib address USENSEO=user sense 

value 


SETLOGON—Modify an Application Program's Capability 
to Establish Sessions 





[symbol ] SETLOGON  RPL=rpl address 
[,rp! field name=new value] ... 


RPL fields that apply to SETLOGON are: 


ACB=acb address OPTCD=QUIESCE| a 
BRANCH=YES!? |NO STARTISTOP 

ECB=ecb pu deena OPTCD=SYNIASY 

EXIT=rpl exit routine address 





1 Applies to MVS only. 
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SHOWCB e@ SIMLOGON 


SHOWCB-—Extract the Contents of Control Block Fields 


ow [symbol] SHOWCB AM=VTAM 
,»ACB=acb address 
,EXLST=exit list address 
,NIB=nib address 
,RPL=rpl address 
‘ew’ ,»AREA=data area address 
,FIELDS=field name|(field 
name,...) 
,LENGTH#=data area length 
[,MF=list, generate, or execute 
wo form parameters] 


SIMLOGON-— Initiate a Session in which the Application 
Program Will Act as the Primary Logical Unit 


[symbol] SIMLOGON  RPL=rpl address 
[,rpl field name=new value] . 


RPL fields that apply to SIMLOGON are: 


ACB=acb address OPTCD=CONANY |ICONALL 
AREA=address of user OPTCD=Q|NQ 
data for Initiate OPTCD=RELRQ| 
. | BRANCH=YES! |NO NRELRO 
aaa ee i ene aera! OPTCD=SYNIASY 
EX1IT=rpl exit routine address) RECLEN=length 
N1IB=nib address of user data 


1 Applies to MVS only. 
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TERMSESS e TESTCB 


TERMSESS— Request Termination of a Session in which 
the Application Program Acts as the Secondary 


Logical Unit = o 


[symbol] TERMSESS RPL=rpl address 
[,rpl field name=new value] ... 


RPL fields that apply to TERMSESS are: 





ACB=acb address NIB=nib address 
ARG= (register) OPTCD=COND| 
BRANCH=YES!|NO UNCOND 





aes address|INTERNAL } OPTCD=SYNIASY 
EXIT=rpl exit routine address 


TESTCB—Test the Contents of a Control Block Field 


[symbol] TESTCB AM=VTAM 

,ACB=acb address 

,EXLST=exit list address 

,.N1IB=nib address 

,RPL=rpl address 

[,ERET=error exit routine 
address] 
field name=test value 

[,MF=list, generate, or execute vw) 
form parameters] 





1 Applies to MVS only. 
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ACB ERROR Field Values 


ERROR Applicable Explanation 


Field Value Macros 
(Hex) OPEN CLOSE 


0 e e OPEN or CLOSE successful 
4 e CLOSE already issued or 
ACB never opened 
14 e Open cannot be processed 


because of a temporary 
shortage of storage 


24 e The ACB's password does 
not match the APPL entry’s 
password 

40 e Outstanding OPNDST 
(ACQUIREs) not released 

42 @ System error prevented 


termination of one or more 
of the application program's 


sessions 

46 e e OPEN or CLOSE not issued 
in mainline program 

48 e CLOSE was not issued in 


a job step task, or ina 
subtask within the 
ACF/VTAM partition.! 

4C ® CLOSE was issued for a pro- 
gram operator application 
but there are messages 
queued for it, or ACF/VTAM 
is waiting for areply, or both 


50 e e ACF/VTAM is not part of 
the operating system 

52 e HALT was issued by the 
operator 

54 e Invalid APPLID 

56 e APPLID is not an APPL 
entry 

58 ® ACB's symbolic name is 


the same as another ACB 
that is already open 





1 Applies to OS/VS1 only. 
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ACB ERROR Field Values (continued) 





ERROR Applicable Explanation 

Field Value Macros 

(Hex) OPEN CLOSE 

5A e APPLID does not match any 


names in the ACF/VTAM 
network configuration tables 
5C e ACF/VTAM is inactive 
5E e Address in APPLID field is 
beyond the program's 
addressable range 





60 e a System error — 
62 e Incorrect APPLID length byte ad 
64 e Address in PASSWD field is 


beyond the program’s 
addressable range 


66 e Incorrect PASSWD length 
byte 
68 e OPEN was issued for a 


Primary program operator, 
when another primary 
program operator is already 
active 

70 6 ® OPEN or CLOSE was issued 
unnecessarily while the 
Program was terminating 
abnormally! 

88 e OPEN cannot be processed 
due to a temporary storage 
shortage.” 

BC ® ACB is being opened, or 
being closed by another eke 
CLOSE macro instruction ww 

F4 e The application program is 
not authorized for 
SRBEXIT=YES.3 











1 Applies to OS/VS only. 
2 Applies to VSE only. 
3 Applies to MVS only. 
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ACB ERROR Field Vatues (continued) 


ERROR 
Field Value 
(Hex) 


F6 


FA 


FE 


Applicable 
Macros 
OPEN CLOSE 
e 
e 
e 


Explanation 


A communication network 
management (CNM) 
application program failed 
to supply a NIB pointer in 
the NIB field of the ACB, or 
the NIB address specified 
lies beyond the addressable 
range of the application 
program . 

An application program 
without CNM authorization 
supplied a NIB pointer in its 
ACB, or if CNM authorized, 
the application program 
failed to supply valid NIB 
options on the NIB macro 
The CNM routing table 
indicated that this applica- 
tion program was to receive 
the same unsolicited 
formatted requests that 
were already being routed 
to another active CNM 
authorized application 
program 
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Manipulative Macro Instruction Return Codes 


Register 15 Explanation 


00 Successful completion 
04 Error—Register O set 
08 Error—Execute form of macro used to enter 
new item in parameter list—Register O not set 
oc System Control Error—Register O set? 
O 
Return a7 O 4g) 
O92SSsSeE 
Code 2 5 Ow 
(RegisterO) % Ss & Explanation 


For 04 in Register 15 


01 eee 
02 eee 
03 eee 
04 ee 
05 e 
06 e 
07 ee 
08 e 

09 e e 
OA ee 
0B 8 
oc e 
0D e 
OE ee 
OF e e 
10 eee 
11 

For OC in Register 15' 
04 eee 
08 eee 
oc eee 





1 Applies to VSE only. 
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Invalid request type 

Invalid block type 

Invalid keyword 

Invalid block 

Reserved (VSAM only) 
Reserved (VSAM only) 
Field nonexistent 
Insufficient main storage 
Insufficient program storage 
No address supplied 

RPL active 

ACB open 

Reserved (VSAM only) 
Invalid parameter list 
Invalid alignment 

Invalid control block (access 
method invalid) 

No internal ECB 


SIZE operand missing from 
program EXEC statement 
Attempt made to run in 

real mode 

SIZE operand does not allow 
enough space for ACF/VTAM 
modules 

















RPL-Based Macro Instruction Return Codes 


RTNCD 
Feedback 


00 
00 
00 
00 
00 


00 


04 
04 
08 
Oc 
oc 


oc 
oc 
10 


10 
10 
10 
10 
10 
10 


10 
10 
10 
10 
10 
10 


14 
14 
14 
14 
14 
14 


FDBK2_ Prablem Definition 


Reason 

00 Normal completion or request accepted 

05 Input area too small 

06 No input available 

07 INQUIRE information not available 

08 OPNDST OPTCD=ACQUIRE, 
SIMLOGON, or CLSDST 
OPTCD=PASS failed 

09 OPNDST OPTCD=ACCEPT denied; no 
queued CINITs 

03 Exception request received 

04 Negative response received 

00 Temporary storage shortage 

OA Request canceled by RESETSR 

OB Request canceled because the session 
has been terminated 

oc Request canceled by Clear request 

OD Prior exception in chain detected 

00 Logical unit, application program 
status, or queued BIND not available 

01 OPNDST failed 

02 Logical unit inhibited for sessions 

03 HALT issued 

05 Request or response encryption failure 

07 Request canceled by VARY command 

09 Unconditional Terminate or 
character-coded logoff received 

OA ACF/VTAM error 

OD ACF/VTAM inactive for your ACB 

OE Request aborted 

OF Buffers filled 

11 SDT failure on OPNDST 

12 Macro instruction failure, sense 
included 

00 VSAM request 

02 Zero EXIT field 

03 Zero ECB field 

04 Inactive RPL checked 

10 Control block invalid 

11 No RTYPE specified 
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RPL-Based Macro Instruction Return Codes (continued) 


-RTNCD  FDBK2_ Problem Definition 


Feedback Reason wa) 
14 12 CLSDST in progress 
14 13 CID invalid 
14 1E Invalid data or length 
14 23 Request type invalid My 
14 24 Request invalid for address space’ wl 
14 3B NFME-NRRN response 
14 3C Previous macro instruction 
outstanding 
14 40 CONTROL invalid 
14 41 Data traffic not allowed be 
14 42 Invalid STYPE for SESSIONC ea 
14 44 RESPLIM exceeded 
14 47 3270 SEND option invalid 
14 48 Session control protocol violation 
14 49 Invalid STSN action/result code 
14 4A Installation exit routine was not 
available 
14 4B INTRPRET sequence or LOGMODE 
invalid or cryptographic incompatibility 
14 4C Invalid search argument for INQUIRE 
or INTRPRET 
14 4D No interpret table 
14 4E Invalid use of NIB list 
14 4F ACQUIRE-ACCEPT option code —— 
invalid — 
14 50 RPL field Invalid | wW 
14 51 OPNDST OPTCD=ACCEPT and 
SIMLOGON not allowed 
14 52 NIB invalid 
14 53 Logical unit not found 
14 55 Application program not authorized, 





application program name not 
available, or task association not 
specified 





1 Applies to MVS only. ‘sail! 
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RPL-Based Macro Instruction Return Codes (continued) 


RTNCD 
Feedback 


14 
14 


14 


14 
14 


14 
14 


14 
14 
14 
14 
14 
14 
14 
14 
14 
14 


14 
14 


FDBK2 Problem Definition 


Reason 

57 Invalid MODE field 

5E CLSDST OPTCD=PASS not 
authorized 

60 Invalid LU name for CLSDST or 
SESSIONC 

61 Invalid SETLOGON 

6C Exceeded limit on outstanding 
RCVCMD requests 

6D Application program not authorized 

6E Syntax error in reply to ACF/VTAM 
operator message 

6F SENDCMD/RCVCMD processor 
inactive 

70 Program operator closing ACB with 
requests outstanding 

71 Operator command not valid 

73 SEND parameter invalid for CNM 

74 Negotiable response to non-negotiable 
BIND 

75\ Invalid negotiable BIND response 
Parameters 

76 Invalid negotiable BIND response 
size 

77 FM Data request unit required 

78 Invalid chain specification 

79 Buffer list length invalid 

7B Invalid user RH 

7C OPTCD=USERRH invalid for 
SESSIONC 
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= How RPL-Based Macro Instruction Error and Special-Condition Information Is Organized 
© 


For RPL-Based Requests 


After a SEND, RECEIVE, CHECK, or other RPL-based macro instruction, the next sequential instruction finds in 


Register 15 


The request was successful; or, for a synchronous request (including CHECK), the operation 


was successful. 
Some other value The request or the operation was not successful. 





Depending on the request and whether or not it was successful, it may be necessary to test 


Register 0 


: If register 15 is zero, register O indicates (with a conditional completion return code) 
Completion code for certain macro instructions whether success was conditional. If register 15 is not 
zero, register 0 can contain a return code from a LERAD or SYNAD exit routine 
or, if there is no LERAD/SYNAD exit routine, register 0 can contain a recovery 


Recovery code 
action return code (generally the code from the RTNCD field of the RPL). 





lf a request or operation was unsuccessful or conditionally successful, the following RPL fields can be exam- 
ined (in either the issuing routine or ina LERAD or SYNAD exit routine) to determine the cause of the exception. 








RPL 


Recovery action return code 


Specific error return code; or conditional completion 
return code if RTNCD=0 (equivalently, if register 15=0). 


Only set for certain System sense information 

macro instructions for 

certain RTNCD-FDBK2 

combinations. See System sense modifier information 
Appendix B in 

ACF/VTAM USENSEI 

Programming User sense information 





in addition, other RPL fields that contain feedback information (such as SEQNO, CHAIN, and CHNGDIR) 
normally used following completion of a requested operation may be used in determining how to handle an 
error or special condition. 


LEL 


cel 


RPL fields are described under the RPL and other macro instruction descriptions in this manual, in the section 
titled, ‘“ACF/VTAM Macro Instructions’’ and are summarized in Appendix A of ACF/VTAM Programming. 


Possible RPL RTNCD,FDOBK2, sense information settings and their meanings are described in this manual, in the 
section titled ‘“ACB ERROR Field Values”, and more fully in Appendix B of ACF/VTAM Programming. 


For Arrival of a Logical Unit Status Request 


After receiving input with a RECEIVE specifying RTYPE=(DFSYN,NRESP) and CONTROL=LUS, the RPL inbound 
sense fields (SSENSEI,SSENSMI, and USENSE1!) will contain error or special condition information from the 
logical unit. 


Register O is of interest in these circumstances 


e@ For certain macro instructions with certain options set (see Appendix B of ACF/VTAM Programming), if register 
15 contains zero, success may be conditional. Register 0 should be examined to see if there is a condition (and 
what it is). 


e@ Ifan error occurred for an RPL-based request and no LERAD or SYNAD exit routine is available, register 15 
contains hex 04, and register O contains a recovery action return code. 


e IifaLERADor SYNAD exit routine is available, it can set register 15 to zero to indicate ‘’Error corrected — 
request or operation successful.’’ If the error is not corrected, register 15 should be nonzero and a return 
code can be passed from LERAD or SYNAD in register 0. 


e If the ACB was not opened, register O contains the RPL request code. 








cel 


Recovery-Action Return Codes and Their General Meanings 
Recovery Active Return Code LERAD or SYNAD 
(In RPL RTNCD Field (Hex)) Exit Scheduled Type of Completion Programmer Action 
No exit scheduled Normal or conditional Continue BORMaher condone! 
processing. 
SYNAD Analyze RPL to choose logic path. 


SYNAD Retriable completion User EXECRPL macro to retry if 
desired. 
recovery coding. : 


SYNAD Call for external intervention. 


14 LERAD Dump program status and continue 
or abend. 
18 (in register O but not LERAD Logic error; RPL Dump program status and continue 
in RTNCD field) invalid or abend. Do not reuse this RPL. 
Others LERAD or SYNAD RPL overwritten PUMP prograny stats and comune 
or abend. Do not reuse this RPL. 








LOSTERM Exit Routine Reason Codes 


Reason Code 
Hex 


Dec 


16 


134 


oc 


10 


Meaning 
Reserved 
Reserved 
Reserved 


The session has been terminated. Immediate 
recovery is unlikely. The application pro- 
gram must issue CLSDST if it has not 
already done so. The cause of the session 
termination may preclude the session from 
being reestablished immediately. 


This reason code is only reported to a PLU 
application program. Some of the types 

of session outages that cause it are 

reported instead through a SCIP exit routine 
(if SONSCIP=YES on the APPL definition 
statement) or otherwise through an NSEXIT 
routine (if one exists). 


The session has been terminated. This 

reason code is reported immediately after 
reason code 24 (hex 18) (unless CLSDST 

has been issued) and is only reported after 
reason code 24. The application program 
may now try to reinitiate the session, for ex- 
ample, by issuing SIMLOGON or OPNDST 
OPTCD=ACQUIRE; however, the application 
program must first issue CLSDST if it has 
not already done so. 


Note: Once the CLSDST macro instruction 
has been issued, session initiation is subject 
to the normal rules. Therefore, if another 
logical unit has a queued session with the 
logical unit, the new session requested by 
the application program whose LOSTERM 
exit routine was invoked may not be im- 
mediately established. 




















LOSTERM Exit Routine Reason Codes (continued) 


Reason Code 


Dec Hex Meaning 
16 10 This reason code is only reported to a PLU 
(continued) application program. Many of the types of 


session outages that cause it are reported 
instead through a SCIP exit routine (if 
SONSCIP=YES on the APPL definition 
statement) or otherwise through an NSEXIT 
exit routine (if one exists). 


20 14 A CTERM Forced request has been 
received. Perhaps the logical unit issued a 
Terminate Forced request, using 
TERMSESS OPTCD=UNCOND, for ex- 
ample. The application program must 
issue a CLSDST. When this completes, the 
application program may attempt to re- 
initiate the session. This reason code is only 
reported to PLU application programs. 


24 18 The session has been terminated. The 
LOSTERM exit routine will be immediately 
rescheduled with reason code 16 (hex 10) 
for this session. (See the reason code 16 
description above.) The application program 
may issue CLSDST at this time, which in turn 
may cancel the execution of the LOSTERM 
exit routine with reason code 16. 


This reason code is only reported to a PLU 
application program. The session outage 
can instead be reported through a SCIP or 
NSEXIT exit routine as is described under 
reason code 16. 


28 1C Reserved 


135 





LOSTERM Exit Routine Reason Codes (continued) 


Reason Code 
Hex 


Dec 
32 


36 


20 


24 


Meaning 


A CTERM Conditional request has been 
received. Perhaps the logical unit issued a 
Terminate Orderly request, using 
TERMSESS OPTCD=COND, for example. 
The application program can choose to 
issue CLSDST now or at some time in the 
future. The interpretation of the receipt of 
CTERM Conditional is not defined by SNA 
or ACF/VTAM. This reason code is only 
reported to a PLU application program. 


Received request or response units for this 
session have been discarded because of a 
lack of buffer space. The session has not 
been terminated, but session data recovery 
procedures are required. This reason 

code may be reported to either a PLU or 
SLU application program. For further 
details, see the description of (RTNCD, 

F DBK2)=(16,15) in Appendix B of 
ACF/VTAM Programming. 


Note: For any of the LOSTERM reason codes that require or 
recommend a CLSDST macro instruction, do not issue 

a second CLSDST if one has already been issued for the 

same session, but possibly for a different reason. 
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Session Outage Notification Summary 


Application 
Program is: Receives: 


CTERM 
Orderly 

















SCIP 


CTERM 

Forced 

CLEANUP 

UNBIND UNBIND 
Notify 

or NSPE 


UNBIND UNBIND 
Notify 
or NSPE 


1 Read each row from left to right. The first nonblank ww 
column for which the exit routine is available represents 
the exit routine that will be scheduled and shows some 
of the key input to that exit routine. 

2 The SCIP exit routine (if available) is scheduled for a 
PLU (for UNBIND) only if SONSCIP=YES is coded on the 
APPL definition statement. For SONSCIP=NO, UNBIND 
is handled as if no SCIP exit routine were available. 


Primary 
Logical 
Unit 










Secondary 
Logical 
Unit 
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Exit Routine Scheduled: ' 


NSEXIT No NSEXIT Exit Routine Available 


LOSTERM? 
a (Reason codes shown in decimal) 
Reason Code 32 


ad No SCIP Exit Routine Available? 


Reason Code 12 or 20 





CLEANUP Reason Code 12, or 24 followed 
by 16 

CLEANUP Reason Code 12, or 24 followed 
by 16 

Notify No Exit Routine Scheduled 

or NSPE 





CLEANUP No Exit Routine Scheduled 


An application program acting as a 


secondary logical unit must have a 
ren” SCIP exit routine. 


Notify No Exit Routine Scheduled 
or NSPE 


31f no LOSTERM exit routine is available, no exit routine 


‘wy’ is scheduled. 
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Session Outage Notification UNBIND Type Codes 
and Reason Codes (Part 1 of 3) 


If LU is PLU a If LU is SLU 


UNBIND type=02 received by SLU ns 02 
~CLSDST OPTCD=PASS by PLU 

UNBIND type=12 received by this LU 12) CU] 12 12 
~Unrecoverable failure of other LU 


UNBIND type=TC received by this LU for TC] CU] 24 TC ns 
then 
16 


any UNBIND type not listed above, including 


(but not restricted to):' 
1 See ACF/VTAM Programming, Chapter 7 the section titled “"Unbind Session (UNBIND).”’ 







Session Outage Notification Signals 


SCIP: UNBIND RU with type code 
NSEXIT: CLEANUP RU (CU) 
LOSTERM: reason code 

(Type and reason codes shown in decimal) 
“ns’’ means “‘exit routine not scheduled” 
















S 
Cc 
| 

P 


v—- OM” 


+4+—-xmMon2 


s[ earceerle 


= 

2 

c 
m 


4+—-“-xmMM!S 








ZmmxaVNOr 


Session Outage Notification Reasons 


UNBIND type=01 received by PLU 


—UNBIND 01 sent by SLU then 







UNBIND type=01 received by SLU 
~CLSDST OPTCD=RELEASE by PLU 
—See “CTERM Forced received by PLU” 

in the rows below. 
—CLOSE by PLU 



































—TC=07 Virtual route inoperative 
—TC=08 Route extension inoperative 
—~TC=09 Hierarchical reset because of 
SSCP session activation 
~TC=10 SSCP session deactivated/failed 
~TC=11 Virtual route deactivated 
~TC=14 Recoverable failure of other LU 
-~TC=15 Cleanup done by other LU 
—TC=254 Protocol violation detected by 
other LU 


CTERM Forced received by PLU 

(PLU sends UNBIND type=01 to SLU) 

—VARY NET,INACT,I of either of LUs, 
CDRSC, CDRM, or associated component 

—HALT NET,QUICK 

—~REQDISCONT Immediate from PU 

~Cross-Domain Takedown (Forced) 
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Session Outage Notification UNBIND Type Codes 
: and Reason Codes (Part 2 of 3) 
Sd 


Session Outage Notification Signals If LUisPLU ff If LUis SLU 


SCIP: UNBIND RU with type code 
NSEXIT: CLEANUP RU (CU) 
LOSTERM: reason code 

en’ (Type and reason codes shown in decimal) 
“‘ns’’ means “exit routine not scheduled’ 


| s 

1 Cc 
| 
P 


Z2amumuavVNor 
zumanor 


Session Outage Notification Reasons 


. CTERM Forced received by PLU 

ww (PLU sends UNBIND 01 to SLU) 
—Terminate Forced by SLU 
—-LOGOFF UNCOND by SLU 
—TERMSESS UNCOND by SLU 
—VARY NET,TERM,UNCOND of session 


CLEANUP received by this LU 

(UNBIND type=01 sent to other LU) 

—VARY NET,INACT,F or R of LU, 
CDRSC, CDRM, or associated component 

—VARY NET,TERM,FORCE of session 

—Cross Domain Takedown Cleanup 

—CLOSE or ABEND by other LU 

—RU received larger than maximum size 
specified in BIND 

—Route extension inoperative 


CLEANUP received by this LU 
(UNBIND type=01 sent to other LU) 
—Terminate Cleanup by this or other LU 
; {Includes Terminate Forced changed to 
‘ow’ Terminate Cleanup by the SSCP) 


Global failure of this LU 
(UNBIND type=01 sent to other LU) 
(TPEND exit routine with reason code 8) 
—HALT NET,CANCEL 
—ABEND of application program 


* / —ACF/VTAM failure 


Failure of this LU for this session 
(UNBIND type=14 sent to other LU) 
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Session Outage Notification UNBIND Type Codes 
and Reason Codes (Part 3 of 3) 






















Session Outage Notification Signals 


LUIS PLU || If LU is SLU 















SCIP: UNBIND RU with type code 
NSEXIT: CLEANUP RU (CU) 
LOSTERM: reason code 

(Type and reason codes shown in decimal) 
‘ns’ means “exit routine not scheduled” 


vu-OaOnN 
4a~-xmMnS! 
Z2mumiawnor 


Session Outage Notification Reasons 


Buffer overflow at this LU 
(Does not cause session termination) 








Test Request message received by PLU 
(UNBIND type=01 sent to the SLU) 
—From BSC 3270 attached to ACF/NCP 





CTERM Orderly received by PLU 
(Does not cause session termination) 
—VARY NET,TERM,COND of session 

—Terminate Orderly by SLU 

—TERMSESS COND by SLU 

~LOGOFF COND by SLU 

—Cross-Domain Takedown Orderly 
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RPL REQ Field Values 


Value 
(Dec) 


(21) 
(22) 
(23) 
(26) 
(27) 
(31) 
(34) 
(35) 
(36) 
(37) 
(39) 
(40) 
(41) 
(42) 
(44) 


Hex 


15 
16 
17 
1A 
1B 
1F 
22 
23 
24 
25 
27 
28 
29 
2A 
2C 


Macro Instruction 


SETLOGON 
SIMLOGON 
OPNDST 
INQUIRE 
INTRPRET 
CLSDST 
SEND 
RECEIVE 
RESETSR 
SESSIONC 
SENDCMD 
RCVCMD 
REQSESS 
OPNSEC 
TERMSESS 
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NSEXIT 
(for 
Notify 
RU) 







NSEXIT 
(for 
NSPE 
RU) 





Parameter Lists for the EXLST Exit Routines 
Register 1 Parameter List 
Exit Routine 1st Word | 2nd Word 3rd Word 
LERAD None (Register 1 contains the RPL 
address for the request that failed) 
LOGON Address of the USERFLD 
ae 
logical unit’s zeros? 
symbolic name 
LOSTERM ACB USERFLD 
address data* 
(for 
CLEANUP 
ACB Reserved USERFLD 
address data? 
ACB Reserved Reserved 
address 
instruction, word 3 contains the USERFLD data from the 
NIB used with REQSESS; otherwise, word 3 contains zeros. 
SIMLOGON macro instruction, word 3 contains USERFLD 
data from the NIB used with SIMLOGON; otherwise, word 3 


DFASY USERFLD 
ae data* 
secondary data or 
NSEXIT ACB CID USERFLD 
address data‘ 
RU) 
: ifthe BIND requastiss. the BIND request is a result of a REQSESS macro 
21f the LOGON exit routine is entered as a result of a 
contains zeros. 
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Parameter Lists for the EXLST Exit Routine (continued) 


Register 1 Parameter List 
Exit Routine 4th Word | 5th Word 6th Word 
DFASY Reserved | Address of Reserved 
ready-only RPL 
LERAD None (Register 1 contains the RPL 
address for the request that failed) 


LOGON Length Address of CID 
of logon read-only RPL 
message (RPL contains 

the address of 
the CINIT RU.) 


LOSTERM Reason Reserved Reserved 
code 


NSEXIT Reserved | Address of Reserved 
(Cleanup) read-only RPL 
(RPL contains 
address of 
CLEANUP RU.) 
Reserved | Address of Reserved 
read-only RPL 
(RPL contains 
address of 
Notify RU.) 
NSEXIT Reserved | Address of 


(NSPE) read-only RPL 
(RPL contains 
address of 
NSPE RU.) 
3Word 3 contains the USERFLD data from the NIB used 
with REQSESS, SIMLOGON, or CLSDST OPTCD PASS. 
*Word 3 contains the USERFLD data from the NIB used 
with OPNDST or OPNSEC. 
































NSEXIT 
(Notify) 
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Parameter Lists for the EXLST Exit Routines (continued) 





Register 1 Parameter List 


2nd Word 3rd Word 










1st Word 





Exit Routine 








RELREQ ACB 


address 


Address of the 
secondary 
logical unit's 
symbolic 
name 


Reserved 






























ACB CID USERFLD 
address data? 
ACB CID USERFLD 






data or 
zeros! 


address 





ACB CID USERFLD? 
address 


SCIP 
(for 

other than 
BIND RU) 














None (Register 1 contains the RPL 
address for the request that failed) 


TPEND ACB Reason-code Reserved 
address 


11f the BIND request is a result of a REQSESS macro 
instruction, word 3 contains the USERFLD data from the 
NIB used with REQSESS; otherwise, word 3 contains zeros. 

2Word 3 contains the USERFLD data from the NIB used 
with OPNDST or OPNSEC. 
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Parameter Lists for the EXLST Exit Routines (continued) 







Register 1 Parameter List 


4th Word | 5th Word 6th Word 





Exit Routine 





RELREQ 





















Reserved 


Reserved 


Reserved 
Reserved 


None (Register 1 contains the RPL 
address for the request failed) 


Reserved | Reserved 





Address of 
read-only RPL 


Reserved 















Address 
of the 
session 
param- 
eters 


Address of 
read-only RPL 
(RPL contains 
the address of 

the BIND RU.) 




















Reserved | Address of 





SCIP 







(for read-only RPL 
other than (For UNBIND, 
BIND RU) the RPL con- 


tains the address 
of the UNBIND 
RU.) 
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Macro Instructions That Create DSECTs 


Control Block 
ACB 


EXLST 
RPL 


Device character- 
istics field in NIB 
Processing options 
field in NIB 
RTNCD-F DBK2- 
FDBK fields 
in RPL 
NIB 
Session parameters 
Program operator 
message and 
command header 
Request/response 
header 
Buffer list entry 


DSECT Name 
and Operands 


IFGACB 


IFGEXLST 


IFGRPL 


ISTDVCHR 
ISTDPROC 
ISTUSFBC 
ISTONIB 
ISTDBIND 
ISTDPOHD 


ISTRH 
ISTBLENT 


AM=VTAM 
[, DSECT=YESI|NO] 
AM=VTAM 
[, DSECT=YES|NO] 
AM=VTAM 
[, DSECT=YESI|NO] 


[DSECT=YES|NO] 


[DSECT=YES|NO] 


In coding these macro instructions, do not use elsewhere 











in the program any label beginning with: 


ACB 
BIN 

BLE 
DEV 
EXL 
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IFG 
IST 
NIB 
POH 
PRO 


RH 

RPL 
RSV 
USF 








PART 4. SNA REFERENCE DATA 
Format of BNDAREA (ISTDBIND) 


Displacement 
Dec Hex 
0 0 


4 4 
8 8 
12 Cc 
16 10 
20 14 
24 18 
28 1c 
32 20 
36 24 


(BINFMT) 


Format Type 
[TYPE] 


Secondary LU 
Protocols 
[SECPROT] 
(BINSECP) 


Secondary 
Receive 
Pacing Count 
[SRCVPAC] 
{(BINRPACE) 


Primary Receive 
Pacing Count 


(BINBPACE) 


(BINTYPE) 


TS Profile 
[TSPROF] 


FM Profile 
{[FMPROF} 
{(BINFM) (BINTS) 
Common LU Protocols 
{COMPROT] 


(BINCMNP) (BINCMNP2) 


Maximum Request 
Unit Send Sizes 
(RUSIZES) 


Secondary LU 
(BINSRUSZ) 


Primary LU 
(BINPRUSZ) 


Presentation 
Services 
Profile 
{[PSERVIC] 
(BINLUP) 


[PSERVIC] 


(BINPSCHR) 


Length of 
Cryptographic § Primary LU 
Control Name 
{(BINCRCTL) (BINPRIML) 


Name of Primary Logical Unit 


(BINPRIMN) 


Primary LU 
Protocols 
{[PRIPROT] 
(BINPRIP) 


Secondary 
Send Pacing 
[SSNDPAC] 
(BINAPACE) 


Primary Send 
Pacing Count 
[PSNDPAC] 

{(BINSPACE) 


Logical Unit Presentation Services Usage Field 


User Data 
Length 


(BINUSEL) 





User Data 
(BINUSE) 


The heavily outlined section is the fixed-length portion of 


BIND. The names in brackets are the operands of the 
MODEENT macro used to build the corresponding fields in 

a logon mode table entry. For further information refer to 
the ACF/VTAM Planning and Installation Reference manual. 
The names in parentheses are the ISTDBIND DSECT labels 
for the field. 
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Index of RUs by NS Headers and Request Codes 


010002 


010003 
010004 


010201 
010202 
010203 
010204 
010205 
010206 
010207 
010208 
010209 
01020A 
010208 
01020E 
01020F 
010211 


010214 
010215 
010216 
010217 
010218 
010219 


01021A 
010218 
010222 


010280 
010281 
010284 
010285 
0102FFA0 
0102FFA1 
0102FFA2 
0102FFA3 
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ACF/ 
VTAM 
RU Control 
RU Name Category | Block 
Change Negative 
Response Poll Limit 
Change Session Limit 
Chg Service Seeking 
Pause 
Contact 
Discontact 
IPL Initial 
IPL Text 
IPL Final 
Dump Initial 
Dump Text 
Dump Final 
Remote Power Off 
Activate Link 
Deactivate Link 
Connect Out 
Abandon Connection 
Set Control Vector 
(Configuration 
Services) 
Entering Slowdown 
Exiting Slowdown 
Activate Connect In 
Deactivate Connect In 
Abandon Connect Out 
Assign Network 
Address 
Free Network Address 
Request Discontact 
Set Control Vector 
(Configuration 
Services) 
Contacted 
Inoperative 
Request Contact 
NS Lost Subarea 
Allocate Resource 
Free Resource 
Set Routable State 
Reset Routable State 


SNA 
Abbreviation 


CONTACT 
DISCONTACT 
IPLINIT 
IPLTEXT 
IPLFINAL 
DUMPINIT 
DUMPTEXT 
DUMPFINAL 
RPO 
ACTLINK 
DACTLINK 
CONNOUT 
ABCONN 
SETCV 


ESLOW 
EXSLOW 
ACTCONNIN 
DACTCONNIN 
ABCONNOUT 
ANA 


FNA 
REQDISCONT 


CONTACTED 
INOP 
REQCONT 
NSLSA 











Index of RUs by NS Headers and Request Codes 


010301 
010302 
010303 
010311 


010331 
010334 
010361 


010382 
010383 
010480 


010604 


010680 
010681 
010682 
010683 


04 
05 
05 
06 


06 
07 
08 
09 
OA 
0B 
oc 
0D 


0D 
OE 


ACF/ 
VTAM 
Contro/ 
RU Name Block 
Execute Test 
Activate Trace 
Deactivate Trace 
Set Control Vector 
(Maintenance 
Services) 
Display Storage 
Record Storage 
Record Maintenance 
Stats 
Record Test Data 
Record Trace Data 
Record Measurement 
Data 
Net Services Proc 
Error 
Initiate Other 
Initiate Self Format-0 
Terminate Other 
Terminate Self 
Format-0 
Logical Unit Status 
Ready to Receive 
Lost Subarea 
Entering Auto Net 
Shutdown 
Explicit Route 
Inoperative 
ANS Complete 
Lost Path 
Explicit Route Test 
Explicit Route Test 
Reply 
Explicit Route 
Activate 
Explicit Route 
Activate Reply 
Activate Logical Unit 
Activate Virtual Route 
Deactivate Logical 
Unit 





SNA 
Abbreviation 


ACTTRACE 
DACTTRACE 
SETCV 


DISPSTOR 
RECSTOR 
RECMS 


RECTD 
RECTRD 


INIT-SELF 
TERM-SELF 
LUSTAT 
RTA 

LSA 

ANSS 
ERINOP 


ANSC 


ERACT 
ERACTRPLY 
ACTLU 


ACTVR 
DACTLU 
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Index of RUs by NS Headers and Request Codes 


11 
12 


14 
14 


15 
31 
32 
3F0233 
3F0234 
410210 


41021C 


410237 
410240 


410243 
410244 
410245 
410246 
410285 
410286 


410287 
4102FF10 
410TF66 
4102FFBD 
4102F FBE 
4102FFBF 


4102FFCD 
4102FFCE 
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ACF/ 

VTAM 

Control 
RU Name Block 


Deactivate Virtual 
Route 

Explicit Route 
Operative 

Activate Physical Unit 

Deactivate Physical 
Unit 

Activate CORM 

Activate CDRM 
Response 

Deactivate CORM 

Bind Session 

Unbind Session 

Initiate Load 

Load Status 

Request Net Addr 
Assign 

Delete Network 
Resource 

Load Required 

Add Network 
Resource 

NS IPL Initiate 

NS IPL Text 

NS IPL Final 

NS IPL Abort 

Lost Subarea 

Req Delete Net 
Resource 

Network Services Lost 
Control Point 

Request Network 
Address Assignment 

Exchange !D 

Add Link 

Add Link Station 

Delete Network 
Resource 

Request Dump 

Request Conditional 
Load 





SNA 
Abbreviation 


DACTVR 


EROP 


ACTPU 
DACTPU 


ACTCDRM 
ACTCDRM 


DACTCORM 
BIND 
UNBIND 
INITLOAD 
LOADSTAT 
RNAA 


DELETENR 


LDREQD 
ADONR 


IPL-INIT 
IPL-TEXT 
IPL-FINAL 
{PL-ABORT 
NSLSA 
REQDELNR 


NSLCP 


ADDLK 
ADDLS 
DELETENR 


REQDUMP 
REQLOADC 











index of RUs by NS Headers and Request Codes 


4102F FCF 


410304 


410305 
410306 
416384 
410385 
410386 
4106F FO1 
4106FFO2 
50 

51 


52 


63 


70 
71 


80 


81 

810387 
810389 
810601 
810602 
810620 
810629 
810680 
810681 
810682 
810683 


810685 
810686 
810687 
810688 
8106FF80 
810810 


ACF/ 
VTAM 
Control 
Block 


RU 

RU Name Category 

Request Unconditional 
Load 

Request Maintenance 
Statistics 

Enter Test Mode 

Request Route Test 

Record Formatted MS 

Record Test Results 

Explicit Route Tested 

OPEN ACB 

CLOSE ACB 

NCP Init Complete 

Switch line EP to 
NCP mode 

Switch line NCP to 
EP mode 

Service Manager 
Parameter List 

Bracket Init Stopped 

Stop Bracket 
Initiation 

Quiesce At End Of 
Chain 

Quiesce Complete 

Request Echo Check 

Echo Test 

Control Initiate 

Control Terminate 

Notify 

Cleanup Session 

Initiate Other 

Initiate Self Format-1 

Terminate Other 

Terminate Self 
Format-1 

Bind Failure 

Session Started 

Unbind Failure 

Session Ended 

Reallocate 

Forward 





SNA 
Abbreviation 


REQLOADU 


REQMS 


TESTMODE 
RECFMS 
RECTR 


SBI 


QEC 


ac 
REQECHO 
ECHO 

CINIT 
CTERM 
NOTIFY 
CLEANUP 
INIT-OTHER 
INIT-SELF 
TERM-OTHER 
TERM-SELF 


BINDF 
SESST 
UNBINDF 
SESSEND 


FORWARD 
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Index of RUs by NS Headers and Request Codes 


810AFFOO 


810AFFO1 


810AFFO2 


810AFF10 
810AFF20 


810AFF21 
810AFF30 
810AFF31 
810AFF32 
810AF F33 
810AFF34 
810AFF35 
810AFF36 
810AFF37 
810AFF38 
810AFF40 
810AFF50 
810AFF51 
810AFF60 
810AFF70 
810AFF80 
810AFF90 
810AFFAO 
810AF FBO 


810812 
8108F FO1 
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ACF/ 
VTAM 
Control 
Block 


SNA 
Abbreviation 


API SETLOGON 
(START) 
API SETLOGON 
{STOP) 
API SETLOGON 
QUIESCE 
API SIMLOGON 
API OPNDST 
(ACQUIRE) 
API OPNDST 
(ACCEPT) 
APLINQUIRE 
(LOGONMSG) 
API INQUIRE 
(DEVCHAR) 
API INQUIRE 
(COUNTS) 
APi INQUIRE 
(TOPLOGON) 
API INQUIRE 
CIDXLATE 
API INQUIRE 
(TERMS) 
API INQUIRE 
(APPSTAT) 
API INQUIRE 
(SESSPARMS) 
APt INQUIRE 
(SESSKEY) 
APL INTERPRET 
API CLSDST (PASS) 
API CLSDST 
(RELEASE) 
AP! SESSIONC 
AP! SENDCMD 
API RCVCMD 
AP! REQSESS 
API OPNSEC 
API TERMSESS 
Deliver 
Notify 


DELIVER 














Index of RUs by NS Headers and Request Codes 


818620 
818627 
818640 


818641 
818643 


818643 


818645 


818646 
818648 
818649 


81864A 


81864B 
82 
83 
84 
AO 
Al 
A2 


A3 
co 
co 
Ci 
C2 
C8 
cg 


ACF/ 
VTAM 
Control 
RU Name Block 
Cross-Domain Notify 
Direct Search List 
Cross-Domain Init 
Other 
Cross-Domain Initiate 
Cross-Domain 
Terminate 
Cross-Domain 
Terminate 
CD Session Setup 
Failure 
CD Session Started 
CD Session Ended 
Cross-Domain 
Takedown 
CD Takedown 
Complete 
CD Control Initiate 
Release Quiesce 
Cancel 
Chase 
Start Data Traffic 
Clear 
Set and Test Sequence 
Nos 
Request Recovery 
Cryptography Verify 
Shutdown 
Shutdown Complete 
Request Shutdown 
Bid 
Signal 
Virtual Route 
inoperative 
Notify (drive 
LOSTERM)}) 
Set Session Address 
Set Session Address 
with Disconnect 
Override Session 
Address 


SNA 
Abbreviation 


NOTIFY 
DSRLST 
INIT-OTHER-CD 


CDINIT 
TERM-SELF-CD 


CDTERM 


CDSESSF 


CDSESSST 
CDSESSEND 
CDTAKED 


CDTAKEC 


CDCINIT 
RELQ 
CANCEL 
CHASE 
SDT 
CLEAR 
STSN 


ROR 
CRV 
SHUTD 
SHUTC 
RSHUTD 
BID 

SIG 
VRINOP 
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Index of RUs by NS Headers and Request Codes 
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ACF/ 
VTAM 
Control 
Block 


Purge Wait Queue 

Flush Virtual Route 
Sessions 

Request Explicit 
Route Activate 

Request Virtual Route 
Deactivate 

Generic Bind 

Generic Unbind 

Virtual Route Status 





SNA 
Abbreviation 


FLUSH 
REQERACT 
REQDACTVR 
GBIND 


GUNBIND 
VRSTAT 














Logical Unit Presentation Services Profiles and 
Protocols! 


LU Type 0 


Use of a set of protocols and data streams agreed upon by 
the logical units involved; SNA does not define them 


LU Type 1 


Use of an SNA character string (SCS) and a defined set of 
SNA protocols for a keyboard/printer device 


Use of predefined function management headers to identify 
a variety of data set types and controls that can be sent and 
received 


LU Type 2 


Use of a 3270 data stream and a defined set of SNA 
protocols for a keyboard/display device 


LU Type 3 


Use of a 3270 data stream and a defined set of SNA 
protocols for a printer 


LU Type 4 


Use of an SNA character string (SCS) and a defined set of 
SNA protocols for a batch input/output LU having associated 
with it a printer and a magnetic stripe reader/recorder 


LU Type 6 


Use of SNA character string (SCS) and structured field data 
streams between application programs in a distributed 
processing environment 





1 Refer to Systems Network Architecture: Sessions between 
Logical Units, GC20-1868, and Systems Network 
Architecture: Concepts and Products, GC30-30772, for 
additional information. 
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Transmission Services Profiles’ 


Session Control Requests for Each Transmission Services 
Profile 





Transmission Services Profile 





Opt 
NA | NA | Opt 
NA Req 
NA | NA | Opt a 


Key: Req — This request must be used. The required 
requests may be issued by ACF/VTAM 
on behalf of the application program. 


Opt — This request may be used. 
NA — Not applicable. This request must not be used. 





- 1 Refer to the Systems Network Architecture Reference 
Summary, GA27-3136, for additional information. 


158 





Transmission Services Usage Field Request Unit Size 


The session parameters specify the maximum length of 
request units that can be sent by the logical units. This 
information is divided into two parts: the secondary logical 
unit send request unit size (byte 9) and the primary logical 
unit send request unit size (byte 10). Both bytes have the 
same format; however, they may be set to different values 
depending upon the requirements of the logical units. The 
bits that can be set are listed below. 


Warning: The displacements indicated below apply to the 
ISTDBIND DSECT. These displacements are one greater 
in the actual BIND RU, since the BIND RU contains a 
request code that is not contained in the ISTDBIND 
DSECT. 


Bit Setting 
(Bytes 9 and 10) 
0123 4567 Meaning 


Oo... .... (byte 9) 6K bytes is the default maxi- 
mum length of the request unit that can 
be sent by the SLU. ACF/VTAM will 
terminate a session on behalf of the 
PLU if a larger RU is received. 


Oona oes (byte 10) There is no limit specified for 
the size of the request unit that can be 
sent by the PLU. 


1000 .... __ This is the mantissa (m) of the formula 
m x 2" used to determine the length of 
request units that can be sent by the 
1111 gk Shy primary or secondary logical unit. 


through 


0000 _ This is the exponent (n) of the formula 
m x 2" used to determine the maximum 
length of request units that can be sent 

1111 by the primary or secondary logical unit. 


through 


For example, if byte 9 or 10 is set to hex 85, then the 
mantissa is 8 and the exponent is 5; the associated RU 
size is 256 bytes (8 x 2°). Refer to the table on the next 
page for all possible values. For a discussion of maximum 
RU size when using SEND OPTCD=LMPEO, refer to 
ACF/VTAM Programming. 
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Maximum Size of Request Unit (in decimal) 


Bits 4-7(n) 


Bits 4-7(n) 


160 


RU Size 
Byte 


OAN OO A WN — O 


mi, apt, 


RU Size 
Byte 


OMAN OO hWN — © 


8 


32 

64 

128 
256 
512 
1024 
2048 
4096 
8192 
16384 
32768 
65536 
131072 
262144 


C 
(12) 


24 

48 

96 

192 
384 
768 
1536 
3072 
6144 
12288 
24576 
49152 
98304 
196608 
393216 


Bits 0-3(m) 


9 

18 

36 

72 

144 
288 
576 
1152 
2304 
4608 
9216 
18432 
36864 
73728 
147456 
294912 


A 
(10) 


20 

40 

80 

160 
320 
640 
1280 
2560 
5120 
10240 
20480 
40960 
81920 
163840 
327680 


Bits 0-3(m) 


D 
(13) 


13 

26 

52 

104 
208 
416 
832 
1664 
3328 
6656 
13312 
26624 
53248 
106496 
212992 
425984 


E 
(14) 


28 

56 

112 
224 
448 
896 
1792 
3584 
7168 
14336 
28672 
57344 
114688 
229376 
458752 


B 
(11) 


11 

22 

44 

88 

176 
352 
704 
1408 
2816 
5632 
11264 
22528 
45056 
90112 
180224 
360448 


F 
(15) 


15 

30 

60 

120 
240 
480 
960 
1920 
3840 
7680 
15360 
30720 
61440 
122880 
245760 
491520 





I 


Sense Codes 


Sense Codes 


The information in this section is adapted from information 
presented in the SVA Format and Protocol Reference 
Manual: Architectural Logic, SC30-3112, and is provided 
here for the convenience of the reader. Although the infor- 
mation was accurate at the time it was published, it is subject 
to change. The manual cited above should be regarded as the 
official source of this information. 


The sense data included with an exception request (EXR), a 
negative response, or a send check is a 4-byte field (see 
below) that generally includes a 1-byte category value, a 
1-yte modifier value, and 2 bytes of implementation- or 
end-user-defined data (hereafter referred to as user-defined 
data). For certain sense codes, user-defined data cannot be 
included in the sense data (it is never carried in send-check 
sense data); in its place is sense code specific information, 
whose format is defined along with the sense code definition, 
below. 


Byte 


Sense code specific 


Category | Modifier | fields or user-defined 
data 





|< Sense Code ——> 
| <_____- sense Data 


Together, the category and modifier bytes hold the sense 
code (SNC) defined for the exception condition that has 
occurred. 
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Sense Codes 


The following categories are defined; all others are reserved: 


Hex 

Value Category 

00 User Sense Data Only 

08 Request Reject 

10 Request Error 

20 State Error 

40 Request Header (RH) Usage Error 
80 Path Error 


The category ‘‘user sense data only”’ (hex 00) allows the end 
users to exchange sense data in bytes 2-3 for conditions not 
defined by SNA within the other categories (and perhaps 
unique to the end users involved). The modifier value is also 
hex 00. 


The sense codes for the other categories are discussed below. 
For these categories, a modifier value of hex 00 can be used 
(as an implementation option) when no definition of the 
exception condition beyond the major category is to be 
identified. 
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Sense Codes 


Request Reject (Category Code Hex 08) 


This category indicates that the request was delivered to the 
intended half-session component and was understood and 
supported, but not executed. 


Sense Code 
{Hex} 


0801 


0802 


0803 


0804 


0805 


0806 


0807 


0808 


Meaning 


Resource Not Available: The LU, PU, or 
link specified in an RU is not available. 


Intervention Required: Forms or cards are 
required at an output device, or a device is 
temporarily in local mode, or other condi- 
tions require intervention. 


Missing Password: The required password 
was not supplied. 


Invalid Password: The password was not 
valid. 


Session Limit Exceeded: The requested 
session cannot be activated, as one of the 
NAUs is at its session limit. Applies to 
ACTCDRM, INIT, BIND, and CINIT 
requests. 


Resource Unknown: The request contained 
a name or address not identifying a PU, LU, 
link, or link station known to the receiver. 


Resource Not Available—LUSTAT 
Forthcoming: A subsidiary device will be 
unavailable for an indeterminate period of 
time. LUSTAT will be sent when the device 
becomes available. 


Invalid Contents ID: The contents !D con- 


tained on the ACTCDRM request was found 
to be invalid. 
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Sense Codes 


Sense Code 
(Hex) Meaning 





0809 Mode Inconsistency: The requested func- 
tion cannot be performed in the present 
state of the receiver. 


080A Permission Rejected: The receiver has 

denied an implicit or explicit request of the 
sender; when sent in response to BIND, it 
implies either that the secondary LU will 
not notify the SSCP when a BIND can be 
accepted, or that the SSCP does not recog- 
nize the NOTIFY vector key hex OC. (See  # 
the hex 0845 sense code for a contrasting es 
response.) 





080B Bracket Race Error: Loss of contention 
within the bracket protocol. Arises when 
bracket initiation/termination by both 
NAUs is allowed. 


O080C Procedure Not Supported: A procedure 
(Test, Trace, IPL, REQMS type) specified 
in an RU is not supported by the receiver. 


080D NAU Contention: A request to activate a 
session was received while the receiving half- 
session was awaiting a response to a pre- 
viously sent activation request for the same 
session; for example, the SSCP receives an 
ACTCDRM from the other SSCP before it 
receives the response for an ACTCDRM that 
it sent to the other SSCP and the SSCP ID 
in the received ACTCDRM was less than or 
equal to the SSCP ID in the ACTCDRM 
previously sent. 








O80E NAU Not Authorized: The requesting NAU os 
does not have access to the requested en” 
resource. 
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Sense Code 
(Hex) 


O80F 


0810 


0811 


0812 


0813 


0814 


0815 


0816 





Sense Codes 


Meaning 


End User Not Authorized: The requesting 
end user does not have access to the re- 
quested resource. 


Missing Requester 1D: The required re- 
quester 1D was missing. 


Break: Asks the receiver of this sense code 
to terminate the present chain with 
CANCEL or with an FMD request carrying 
EC. The half-session sending the Break 
sense code enters chain-purge state when 
Break is sent. 


Insufficient Resource: The receiver cannot 
act on the request because of a temporary 
lack of resources. 


Bracket Bid Reject—No RTR Forthcoming: 
BID (or BB) was received while the first 
speaker was in the in-bracket state, or while 
the first speaker was in the between-brackets 
state and the first speaker denied permission. 
RTR will not be sent. 


Bracket Bid Reject—RTR Forthcoming: 
BID (or BB) was received while the first 
speaker was in the in-bracket state, or 
while the first speaker was in the between- 
brackets state and the first speaker denied 
permission. RTR will be sent. 


Function Active: A request to activate a 
network element or procedure was received, 
but the element or procedure was already 
active. 


Function Inactive: A request to deactivate 
a network element or procedure was 
received, but the element or procedure was 
not active. 
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Sense Codes 


Sense Code 
(Hex) 


0817 


0818 


0819 


081A 


081B 


081C 


166 


Meaning 


Link Inactive: A request requires the use of 
a link, but the link is not active. 


Link Procedure in Process: CONTACT, 
DISCONTACT, IPL, or other link procedure 
was in progress when a conflicting request 
was received. 


RTR Not Required: Receiver of Ready to 
Receive has nothing to send. 


Request Sequence Error: Invalid sequence 
of requests. 


Receiver in Transmit Mode: A race condi- 
tion: normal-flow request received while 
the half-duplex contention state was not- 
receive, (*S, IR), or while resources (such as 
buffers) necessary for handling normal-flow 
data was unavailable. (Contrast this sense 
code with hex 2004, which signals a protocol 
violation.) 


Request Not Executable: The requested 
function cannot be executed, because of a 
permanent error condition in the receiver. 


The following list shows ACF/VTAM- 
unique codes that are set as part of sense 
code 081C. 


OS/VS User Sense Codes for Request Load 
(Conditional) and Request Load 
(Unconditional) Request Units 


Sense Data Meaning 


081C0008 ACF/VTAM is unable to 
successfully open the data 
set containing the NCP 
load module. 








Sense Data 


081C0014 


081C0018 


081C001C 


081C0020 


081C0024 


081C002C 


081C0030 


Sense Codes 


Meaning 


The loaded NCP has 
encountered an error pre- 
venting successful 
initialization. 


Load not performed — 
HALT is in progress. 


The communication con- 
troller dump/load/restart 
router (module ISTINCDP) 
has received an input work 
element which contains an 
unrecognized command 
code. The NCP load 
module is not present in 
the load module data set 
(BLDL failure). 


A permanent I/O error 
has occurred on the com- 
munication controller. 


ACF/VTAM is unable to 
successfully open the data 
set containing the 
diagnostics programs 
(ddname “INITTEST”). 


The diagnostic program has 
detected a probable com- 
munication controller 
hardware error. 


The NCP or diagnostics 
program load module has a 
block size greater than 
1024 bytes (the ‘‘DC’”’ 
option was not specified 
when the link-edit was 
performed). 
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Sense Codes 


168 


Sense Data 


081CO003C 


08100040 


081C0044 


081C004C 


081C0050 


081C0054 


081C0058 


081 CO05C 


Meaning 


The communication con- 
troller unit control block 
does not contain a valid 
value for the channel 
adapter type field. 


The NCP or diagnostics 
program load module is 
improperly constructed. 


The IFLOADRN com- 
munication controller 
load utility program is 
unable to allocate 
sufficient storage. 


The NCP load module size 
exceeds the storage 
capacity of the communi- 
cation controller. 


A permanent !/O error has 
occurred on the NCP load 
module library. 


A permanent I/O error has 
occurred on the diagnostics 
program load module 
library (ddname 
“INITTEST"”). 


A diagnostics program can- 
not be located in the 
diagnostics program load 
module library (ddname 
“INITTEST’) — BLDL 
failure. 


Request Load (Condi- 
tional) is attempted while 
another host is already 
loading the communication 
controller (unit exception 
on SENSE channel 
program). 








Sense Codes 


Sense Data Meaning 


081CO060 Request Load (Condi- 
tional) is attempted while 
another host is already 
loading the communica- 
tion controller (Start 
1/O condition code = 3 
on SENSE channel 
program). 


081C0064 A Load 1/O operation 
(to a link-attached com- 
munication controller) 
has been purged (by Vary 
Deactivate or error 
recovery of the com- 
munication controller or of 
another node in the path 
to the communication 
controller). 


081C0068 A Load |/O operation (to 
a link-attached com- 
munication controller) has 
failed (a negative response 
has been generated by the 
adjacent communication 


controller). 

081C008C The NCP load module has 
an entry point address of 
zero. 

081COO0AB Load not performed — the 


load subtask has abended. 


VSE User Sense Codes for Request 
Load (Conditional) and Request Load 
(Unconditional) Request Units 


Sense Data Meaning 
081C0008 An error has occurred 
during processing of 


the diagnostic data set. 
The operator decided 
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Sense Codes 


170 


Sense Data 


081CO00C 


081C0010 


081C00 14 


081C0018 


081C001C 


081C00064 


081C00068 


Meaning 


not to continue pro- 
cessing the nondiagnostic 
load. 


One of the following has 
occurred: 


A permanent I/O error on 
the diagnostic or load- 
module data set 


A probable 3705 hardware 
error, detected by the 
diagnostic program 


A permanent 1/O error 
on the communication 
controller. 


A time-out has occurred 
while the Diagnostic 

Load program was running 
(Hardstop in the com- 
munication controller). 


An invalid symbolic unit 
exists in the RDT for the 
NCP data set. 


An error has occurred 
during processing of the 
NCP file. 


An error has occurred 
during the loading of the 
Loader Bootstrap. 


The remote communica- 
tion controller oad |/O 
has been purged. 


The remote communica- 
tion controller |/O has 
failed. 











Sense Codes 


User Sense Codes for Request Dump 
Request Units 


Sense Data Meaning 


081C0004 A requested communica- 
tion controller dump has 
been terminated because of 
a permanent I/O error on 
the dump file — the dump 
is partially complete and 
can be formatted and 
printed. 


081C0008 A requested communica- 
tion controller dump has 
been terminated because of 
a permanent communica- 
tion controller 1/O error — 
the dump is partially com- 
plete and can be formatted 
and printed. 


081CO00C A requested communica- 
tion controller dump has 
been terminated because of 
a permanent |/O error on 
the dump file — the dump 
data set cannot be for- 
matted and printed. 


081C0010 A requested communica- 
tion controller dump has 
been terminated because of 
a permanent communica- 
tion controller |/O error — 
the dump data set cannot 
be formatted and printed. 


081C0014 Unable to successfully 
open the dump data set. 


081C0018 Dump not performed — 
HALT is in progress. 
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Sense Codes 


172 


Sense Data 


081C001C 


081C0020 


081COOAB 





Meaning 


The dump data set resides 
on a device that is not 
supported by the dump 
utility program. Or, the 
communication controller 
dump/load/restart router 
(module ISTINCDP) has 
received an input work 
element that contains an 
unrecognized command 
code. 


Unable to successfully 
load a necessary dump 
utility module. 


Dump not performed — 
the dump subtask has 
abended. 


User Sense Codes for Activate Link and 
Deactivate Link Request Units 


Sense Data 


081C0004 


081C0008 


081 COO00C 


081C0010 


Meaning 


Invalid Device Address — 
not three valid hexa- 
decimal digits. 


Invalid Device Address — 
specified device does not 
exist (i.e. has not been 
defined in the operating 
system SYSGEN). 


Invalid Device Type — 
specified device is not 
of the correct type. 


Device is already allocated 
to another JOB. 











Sense Data 


08100014 


08100018 


081C0020 


081C0028 


081C0030 


081C0034 


081C0038 


081CO03C 





Sense Codes 


Meaning 


SYS0OO00 is assigned (VSE 
only). 


There are no free channel 
queue entries (VSE only). 


VPBUF storage is in- 
sufficient. 


Unable to deallocate 
device. 


No paths are available to | 
the device (MVS only). 


Invalid resource type in 
ACF/VTAM resource 
definition table entry 
(RDTE) corresponding to 
device to be allocated. 


Cannot locate ACF/VTAM 
resource definition table 
entry (RDTE) corre- 
sponding to device to be 
allocated. 


Device not Usable — 
VARY ONLINE OS/VS 
command has not been 
issued. 


172.1 





Sense Codes 


Sense Code 
(Hex) 


081D 


O81E 


081F 


0820 


0821 


0822 


172.2 


Meaning 


invalid Station/SSCP ID: The station ID or 
SSCP ID in the request was found to be 
invalid. 


Session Reference Error: The request con- 
tained reference to a half-session that was 
neither active nor in the process of being 
activated (generally applies to network 
services requests). 


Reserved. 


Control Vector Error: Invalid data for the 
control vector specified by the target 
network address and key. 


Invalid Session Parameters: Session param- 
eters were not valid or not supported by the 
half-session whose activation was requested. 


Link Procedure Failure: A link-level pro- 
cedure has failed due to link equipment 
failure, loss of contact with a link station, 
or an invalid response to a link request. 
(This is not a path error, since the request 
being rejected was delivered to its 
destination.) 














Sense Code 
(Hex) 


0823 


0824 


0825 


0826 


0827 


0828 


0829 


Sense Codes 


Meaning 


Unknown Control Vector: The control 
vector specified by a network address and 
key is not known to the receiver. 


Unit of Work Aborted: The current unit 
of work has been aborted; when synchro- 
nization point protocols are in use, both 
synchronization point managers are to 
revert to the previously committed 
synchronization point. 


Component Not Available: The LU 
component (a device indicated by an FM 
header) is not available. 


FM Function Not Supported: A function 
requested in an FMD RU is not supported 
by the receiver. 


Intermittent Error—Retry Requested: An 
error at the receiver caused an RU to be 
lost. The error is not permanent, and retry 
of the RU (or chain) is requested. 


Reply Not Allowed: A request requires a 
normal-flow reply, but the outbound data 
flow for this half-session is quiesced or shut 
down, and there is no delayed reply 
capability. 


Change Direction Required: A request 
requires a normal-flow reply, but the half- 
duplex flip-flop state is not-send (1S, *R), 
CD was not set on the request, and there is 
no delayed reply capability. 
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Sense Codes 


Sense Code 
(Hex) 


082A 


082B 


082C 


082D 


082E 


082F 


0830 


174 





Meaning 


Presentation Space Alteration: Presentation 

space altered by the end user while the half- 

duplex state was not-send, (1S, *R); request 
executed. 


Prsentation Space Integrity Lost: Presenta- 
tion space integrity lost (e.g., cleared or 
changed) because of a transient condition— 
for example, because of a transient hard- 
ware error or an end user action such as 
allowing presentation services to be used by 
the SSCP. (Note: The end-user action 
described under sense codes hex 082A and 
084A is excluded here.) 


Resource-Sharing Limit Reached: The 
request received from an SSCP was to 
activate a half-session, alink, ora procedure, 
when that resource was at its share limit. 


LU Busy: The LU resources needed to 
process the request are being used; for 
example, the LU resources needed to 
process the request received from the SSCP 
are being used for the LU-LU session. 


Intervention Required at LU Subsidiary 

Device: Acondition requiring intervention, 
such as out of paper, or power-off, or cover 
interlock open, exists at a subsidiary device. 


Request Not Executable because of LU 
Subsidiary Device: “The requested function 
cannot be executed, due to a permanent 
error condition in one or more of the 
receiver's subsidiary devices. 


Reserved. 

















Sense Code 
{Hex) 


0831 


ww 0832 


0833 


es’ 0834 





Sense Codes 


Meaning 


LU Component Disconnected: An LU 
component is not available because of 
power off or some other disconnecting 
condition. 


Invalid Count Field: A count field con- 
tained in the request indicates a value too 
long or too short to be interpreted by the 
receiver, or the count field is inconsistent 
with the length of the remaining fields. 
Bytes 2 and 3 following the sense code are 
not used for user-defined data; they contain 
a binary count that indexes (zero-origin) the 
first byte of the invalid count field. 


Invalid Parameter (with Pointer and 
Complemented Byte): One or more 
parameters contained in fixed- or variable- 
length fields of the request are invalid or not 
supported by the NAU that received the 
request. Bytes 2 and 3 following the sense 
code are not used for user-defined data. 
Byte 2 contains a binary value that indexes 
(zero-origin) the first byte that contained an 
invalid parameter. Byte 3 contains a trans- 
form of the first byte that contained an 
invalid parameter: the bits that constitute 
the one or more invalid parameters are 
complemented, and all other bits are copied. 


RPO Not Initiated: A power-off procedure 
for the specified node was not initiated 
because one or more other SSCPs have con- 
tacted the node, or because a CONTACT, 
DUMP, IPL, or DISCONTACT procedure is 
in progress for that node. 
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Sense Codes 


Sense Code 
(Hex) 


0835 


0836 


0837 


0838 


0839 


083A 


176 





Meaning 


Invalid Parameter (with Pointer Only): The 
request contained a fixed- or variable-length 
field whose contents are invalid or not 
supported by the NAU that received the 
request. Bytes 2 and 3 following the sense 
code are not used for user-defined data; 
they contain a 2-byte binary count that 
indexes (zero-origin) the first byte of the 
fixed- or variable-length field having invalid 
contents. 


PLU/SLU Specification Mismatch: For a 
specified LU-LU session, both the origin 
LU (OLU) and the destination LU (DLU) 
have only the primary capability or have 
only the secondary capability. 


Queuing Limit Exceeded: For an LU-LU 
session-initiation request (INIT, CDINIT, 
or INIT-OTHER-CD) specifying (1) Initiate 
or Queue (if Initiate not possible) or (2) 
Queue Only, the queuing limit of either the 
OLU or the DLU, or both, was exceeded. 


Reserved. 


LU-LU or SSCP-LU Session Being Taken 
Down: At the time an LU-LU session- 
initiation or termination request is received, 
the SSCP of at least one of the LUs is either 
processing a CDTAKED request or is in the 
process of deactivating the associated 
SSCP-LU session. 


LU Not Enabled: At the time an LU-LU 
session-initiation request is received at the 
SSCP, at least one of the two LUs, although 
having an active session with its SSCP, is not 
ready to accept CINIT or BIND requests. 














iF 


Sense Code 
(Hex) 


083B 


083C 


083D 


O83E 
083F 





Sense Codes 


Meaning 


Invalid PCID: An invalid PCID was 
received, €.g., one containing an invalid 
network address of the SSCP of the 
initiating LU (ILU) or terminating LU 
(TLU), has been received in CDINIT, 
INIT-OTHER-CD, CDTERM, or 
TERM-OTHER-CD; or a PCID that does 
not identify a previously queued request 
has been received in CDINIT (Dequeue) 
or INIT-OTHER-CD (Dequeue); or, a 
PCID that cannot be associated with the 
PCID of any previously processed CDINIT 
has been received on CDCINIT. 


Domain Takedown Contention: While 
waiting for a response to a CDTAKED, a 
CDTAKED request is received by the SSCP 
containing the SSCP-SSCP primary half- 
session. Contention is resolved by giving 
preference to the CDTAKED sent by the 
primary half-session. 


Dequeue Retry Unsuccessful—Removed 
from Queue: The SSCP cannot successfully 
honor a CDINIT (Dequeue) request (which 
specifies ‘‘leave on queue if dequeue-retry 
is unsuccessful’) to dequeue and process a 
previously queued CDINIT request (e.g., 
because the LU in its domain is still not 
available for the specified session), and 
removes the queued CDINIT request from 
its queue. 


Reserved. 


Terminate Contention: While waiting for 

a response to a CDTERM, a CDTERM is 
received by the SSCP of the SLU. Con- 
tention is resolved by giving preference to 
the CDTERM sent by the SSCP of the SLU. 
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Sense Codes 


Sense Code 
(Hex) Meaning 





0840 Procedure Invalid for Resource: The 
named procedure is not supported in the 
receiver for this type of resource (e.g., (1) 
SETCV specifies boundary function support 
for a type 1 node but the capability is not i 
supported by the receiving node, or (2) the ead 
PU receiving an EXECTEST or TESTMODE 
is not the primary PU for the target link). 


0841 Duplicate Network Address: In across- 
domain LU-LU session initiation request, ES 
the SSCP of the DLU determines that the 4 
OLU network address specified in the 
CDINIT request is a duplicate of an LU 
network address assigned to a different LU 
name. 


0842 SSCP-SSCP Session Not Active: The SSCP- 
SSCP session, which is required for the 
processing of a network services request, is 
not active; e.g., at the time an LU-LU 
session-initiation or termination request is 
received, at least one of the following con- 
ditions exists: 


e The SSCP of the ILU and the SSCP of pe 
the OLU do not have an active session wo? 
with each other, and therefore INIT- 

OTHER-CD cannot flow. 


@ The SSCP of the TLU and the SSCP of 
the OLU do not have an active session s % 
with each other, and therefore TERM- end 
OTHER-CD cannot flow. 


e The SSCP of the OLU and the SSCP of 
the DLU do not have an active session 
with each other, and therefore CDINIT 
or CDTERM cannot flow. 
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Sense Code 
(Hex) 


0843 


0844 


0845 


0846 


0847 


0848 





Sense Codes 


Meaning 


Required FMDS Synchronization Not 
Supplied: For example, a secondary LU 
(LU-LU session type 2 or 3) received a 
request with Write Control Code = Start 


Print, along with RQE and “ICD. 


Initiation Dequeue Contention: While 
waiting for a response to a CDINIT 
(Dequeue), a CDINIT (Dequeue) is 
received by the SSCP of the SLU. 
Contention is resolved by giving preference 
to the CDINIT (Dequeue) sent by the 
SSCP of the SLU. 


Permission Rejected—SSCP Will Be 
Notified: The receiver has denied an 
implicit or explicit request of the sender; 
when sent in response to BIND, it implies 
that the secondary LU will notify the SSCP 
(via NOTIFY vector key hex OC) when a 
BIND can be accepted, and the SSCP of the 
SLU supports the notification. (See the 
hex O80A sense code for a contrasting 
response.) 


ERP Request Forthcoming: The received 
request was rejected for a reason to be 
specified in a forthcoming request. 


Restart Mismatch: Sent in response to 
STSN or SDT or BIND to indicate that the 
secondary half-session is trying to execute a 
resynchronizing restart but has received 
insufficient or incorrect information. 


Cryptography Function Inoperative: The 
receiver of a request was not able to 
decipher the request because of a malfunc- 
tion in its cryptography facility. 
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Sense Codes 


Sense Cade 
(Hex) 


0849 


084A 


084B 


084C 


084D 


180 


Meaning 
Reserved. 


Presentation Space Alteration: The presen- 
tation space was altered by the end user 
while the half-duplex state was not-send, 
(1S, *R); request not executed. 


Requested Resources Not Available: 
Resources named in the request, and 
required to honor it, are not currently 
available. It is not known when the 
resources will be made available. 


Bytes 2 and 3 following the sense code are 
not used for user-defined data; they contain 
sense-code-specific information. Settings 
allowed are: 


OO000 Requested resources are not 
available. 


6002 The resource identified by the 
destination program name (DPN) is 
not supported. 


6003 The resource identified by the 
primary resource name (PRN) is 
not supported. 


Permanent Insufficient Resource: Receiver 
cannot act on the request because resources 
required to honor the request are perma- 
nently unavailable. 


Invalid Session Parameters—BF: Session 
parameters were not valid or were un- 
acceptable by the boundary function. Bytes 
2 and 3 following the sense code contain a 
binary count that indexes (zero-origin) the 
first byte of the fixed- or variable-length 
field having invalid contents. 














Sense Code 
(Hex) 


O84E 


O84F 


0850 


0851 


0852 


0853 


Sense Codes 


Meaning 


Invalid Session Parameter — PRI: A 
positive response to an activation request 
(e.g., BIND) was received and was changed 
to a negative response due to invalid 
session parameters carried in the response. 
The services manager receiving the 
response will send a deactivation request 
for the corresponding session. 


Reserved. 


Link-Level Operation Cannot be Performed: 
An IPL, dump, or RPO cannot be performed 
through the addressed link station because 
the system definition or current state of the 
hardware configuration does not allow it. 


Session Busy: Another session that is 
needed to complete the function being 
requested on this session (e.g., to forward 
an NS RU embedded in a FORWARD 
request) is temporarily unavailable. 


Session with Larger Activation Request 
Sequence Identifier Already Active: A 
session has already been activated for the 
subject destination-origin pair by a session- 
activation request that carried a larger 
activation request identifier than the current 
request; the current request (ACTPU or 
ACTCDRM) is refused. 


Terminate (Cleanup) Required: The SSCP 
cannot process the termination request, as 
it requires cross-domain SSCP-SSCP services 
that are not available. (The corresponding 
SSCP-SSCP session is not active.) Terminate 
(Cleanup) is required. 
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Sense Codes 


Sense Code 
(Hex) 


0854—0855 


0856 


0857 
0858 


0859 


- 085A—085F 


182 





Meaning 
Reserved. 


SSCP-SSCP Session Lost: Carried in the 
sense data field ina NOTIFY or NSPE sent 
to an ILU or SSCP (ILU) to indicate that 
the activation of the LU-LU session either 
cannot be completed or is uncertain because 
the SSCP-SSCP session between the two 
domains has been lost. (This sense code 
appears only in NOTIFY or NSPE, not ina 
negative response. Another sense code, hex 
0842, is used on a negative response to 
signal the condition when the condition is 
known at the time the response, e.g., to 
INIT, is prepared.) 


SSCP-LU Session Not Active: The SSCP-LU 
session, required for the processing of a 
request, is not active; e.g., in processing 
REQECHO, the SSCP did not have an active 
session with the target LU named in the 
REQECHO RU. 


Reserved. 


REQECHO Data Length Error: The speci- 
fied length of data to be echoed (in 
REQECHO) violates the maximum RU 
size limit for the target LU. 


Reserved. 











Sense Code 
(Hex) 


0860 


0861 


0862 


0863 





Sense Codes 


Meaning 


Function Not Supported—Continue 
Session: The function requested is not 
supported; the function may have been 
specified by a request code or some other 
field, control character, or graphic character 
inan RU. Bytes 2-3 following the sense 
code are not used for user-defined data; 
they contain a 2-byte binary count that 
indexes (zero-origin) the first byte in which 
an error was detected. This sense code is 
used to request that the session continue, 
thereby ignoring the error. 


Invalid COS Name: The class of service 
(COS) name, either specified by the |LU 
or generated by the SSCP of the SLU from 
the mode table is not in the ““COS name to 
VR identifier list’’ table used by the 

SSCP of the PLU. Bytes 2 and 3 fol- 
lowing the sense code contain hex 0000 if 
the COS name was generated by the SSCP 
or hex 0001 if specified by the ILU. 


Medium Presentation Space Recovery: An 
error has occurred on the current presenta- 
tion space. Recovery consists of restarting 
at the top of the current presentation space. 
The sequence number returned is of the RU 
in effect at the top of the current presenta- 
tion space. Bytes 2 and 3 following the 
sense code contain the byte offset from the 
beginning of the RU to the first byte of the 
RU that is displayed at the top of the 
current presentation space. 


Referenced Local Character Set Identifier 


(LCID) Not Found: A referenced character 
set does not exist. 
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Sense Codes 


Sense Code 
(Hex) 


0864 


0865 
0866 
0867 


0868 


0869 


~ 0870 


0871 


0872 


0873 


- 0874 


184 





Meaning 


Function Abort: A loop will occur upon 
reexecution; the request sender should not 
send the same data. 


Function Abort: Sender is responsible to 
detect the loop. 


Function Abort: Receiver is responsible to 
detect the loop. 


Sync Event Response: Indicates a negative 
response to a synchronization event. 


No Panels Loaded: Referenced format not 
found because no panels are loaded for the 
display. 


Panel Not Loaded: The referenced panel is 
not loaded for the display. 


Reserved. 


Read Partition State Error: A Read Partition 
structured field was received while the dis- 
play was in the retry state. 


Orderly Deactivation Refused: An NC— 
DACTVR (Orderly) request has been 
received, but sessions are assigned to the VR 
and it will not be deactivated. 


Virtual Route Not Defined: There is no 
explicit route number (ERN) designated to 
support this virtual route number (VRN). 


ER Not ina Valid State: The ER supporting 
the requested VR is not in a state allowing 
VR activation. 

















Sense Code 
(Hex) 


0875 


0876 


0877 


0878 


0879 


087A 





Sense Codes 


Meaning 


incorrect or Undefined Explicit Route 
Requested: The reverse ERNs specified 

in the NC—ACTVR do not contain the ERN 
defined to be used for the VR requested, 

or the ERN designated to be used for the 
VR is not defined. 


Nonreversible Explicit Route Requested: 
The ERN used by the NC—ACTVR does 
not use the same sequence of transmission 
groups (in reverse order) as the ERN that 
should be used for the RSP (NC—ACTVR). 


Reserved. 


Insufficient Storage: The storage resource 
required for a data format is not available. 


Storage Medium Error: A permanent error 
has occurred involving a storage medium. 


Format Processing Error: A processing 
error occurred during data formatting. 
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Sense Codes 


Request Error (Category Code Hex 10) 


This category indicates that the RU was delivered to the 
intended half-session component, but could not be inter- 
preted or processed. This condition represents a mismatch 
of half-session capabilities. 








Sense Code 7 
(Hex) Meaning — ; 
1001 RU Data Error: Data in the request RU 

is not acceptable to the receiving FMDS 

component; for example, a character code 

is not in the set supported, a formatted 

data field is not acceptable to presentation 

services, Or a required name in the request 

has been omitted. 
1002 RU Length Error: The request RU was 

too long or too short. 
1003 Function Not Supported: The function 


requested is not supported. The function 
may have been specified by a formatted 
request code, a field in an RU, or a control 
character. 


(Note: This code can also be used instead 
of sense code hex 0826.) 


Bytes 2 and 3 following the sense code are 
not used for user-defined data; they con- 
tain sense-code-specific information. 
Settings allowed are: 





0000 =~ Function requested is not 
supported. 

6002 The resource identified by the 
destination program name (DPN) 
is not supported. 

6003 The resource identified by the 
primary resource name (PRN) 
is not supported. 
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Sense Code 
(Hex) 


1004 


1005 


1006 


1007 


1008 


1009 


Sense Codes 


Meaning 
Reserved. 


Parameter Error: A parameter modifying a 
control function is invalid, or outside the 
range allowed by the receiver. 


Reserved. 


Category Not Supported: DFC, SC, NC, 
or FMD request was received by a half- 
session not supporting any requests in that 
category; or an NS request with byte O was 
not set to a defined value, or byte 1 was 
not set to an NS category supported by the 
receiver. 


Invalid FM Header: The FM header was not 
understood or translatable by the receiver, 
or an FM header was expected but not 
present. 


Bytes 2 and 3 following the sense code are 
not used for user-defined data; they contain 
sense-code-specific information as defined 
in the Systems Network Architecture 
Reference Summary, under ‘‘FM Header”’. 


Format Group Not Selected: No format 
group was selected before issuing a Present 
Absolute or Present Relative Format 
structured field to a display. 


187 





Sense Codes 
State Error (Category Code Hex 20) 


This category indicates a sequence number error, or an RH or 
RU that is now allowed for the receiver’s current session 
control or data flow control state. These errors prevent 
delivery of the request to the intended half-session 
component. 


Modifier 
(Hex) Meaning 


2001 Sequence Number: Sequence number 
received on normal-flow request was not 
1 greater than the last. 


2002 Chaining: Error in the sequence of the 
chain indicator settings (BCI, ECI), such 
as first, middle, first. 


2003 Bracket: Error resulting from failure of 
sender to enforce bracket rules for session. 
(This error does not apply to contention 
or race conditions.) 


2004 Direction: Error resulting from a normal- 
flow request received while the half-duplex 
flip-flop state was not-receive, (*S, IR). 
(Contrast this sense code with hex 081B, 
which signals a race condition.) 


2005 Data Traffic Reset: An FMD or normal- 
flow DFC request received by a half-session 
whose session-activation state was active, 
but whose data-traffic state was not active. 


2006 Data Traffic Quiesced: An FMD or DFC 
request received from a half-session that has 
sent Quiesce Complete or Shutdown 
Complete and has not responded to Release 
Quiesce. 
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Modifier 
(Hex) 


2007 


2008 


2009 


200A 


200B 


200C 


200D 





Sense Codes 


Meaning 


Data Traffic Not Reset: A session control 
request (e.g., STSN), allowed only while the 
data traffic state is reset, was received while 
the data-traffic state was not reset. 


No Begin Bracket: A BID or an FMD 
request specifying BBI=BB was received 
after the receiver had previously sent a 
positive response to Bracket Initiation 
Stopped. 


Session Control Protocol Violation: An SC 
protocol has been violated; a request, 
allowed only after a successful exchange 

of an SC request and its associated positive 
response, has been received before such 
successful exchange has occurred (e.g., an 
FMD request has preceded a required 
Cryptography Verification request). The 
request code of the particular SC request or 
response required, or hex OO if undeter- 
mined, appears in the fourth byte of the 
sense data. There is no user data associated 
with this sense code. 


Immediate Request Mode Error: The 
immediate request mode protocol! has been 
violated by the request. 


Queued Response Error: The queued 
response protocol has been violated by a 
request, i.e., QRI= 1QR when an outstand- 
ing request had QRI=QR. 


ERP Sync Event Error: The ERP synchro- 
nization event protocol has been violated. 


Response Owed before Sending Request: 
An attempt has been made in half-duplex 
(flip-flop or contention) send/receive mode 
to send a normal-flow request when a 
response to a previously received request 
has not yet been sent. 
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Sense Codes 


RH Usage Error (Category Code Hex 40) 


This category indicates that the value of a field or combina- 
tion of fields in the RH violates architectural rules or 
previously selected BIND options. These errors prevent 
delivery of the request to the intended half-session com- 
ponent and are independent of the current states of the 
session. They may result from the failure of the sender to 
enforce session rules. Detection by the receiver of each of 
these errors is optional. 


Sense Code 

(Hex) Meaning 

4001 Invalid SC or NC RH: The RH of a session 
control (SC) or network control (NC) 
request was invalid. For example, an SC 
RH with pacing request indicator set to 1 
is invalid. 

4002 Reserved. 

4003 BB Not Allowed: The begin bracket indi- 
cator (BBI) was specified incorrectly, e.g., 
BBI=BB with BCI= 1BC. 

4004 EB Not Allowed: The end bracket indicator 
(EB!) was specified incorrectly, e.g., 
EBI=EB with BCI= IBC, or by the primary 
half-session when only the secondary may 
send EB, or by the secondary when only the 
primary may send EB. 

4005 Incomplete RH: Transmission shorter than 
full TH-RH. 

4006 Exception Response Not Allowed: 
Exception response was requested when 
not permitted. 

4007 Definite Response Not Allowed: Definite 


response was requested when not permitted. 


190 











Sense Code 
(Hex) 


4008 


4009 


400A 


400B 


400C 


400D 


400E 


400F 





Sense Codes 


Meaning 


Pacing Not Supported: The pacing indi- 
cator was set on a request, but the 
receiving half-session or boundary function 
half-session does not support pacing for 
this session. 


CD Not Allowed: The change direction 
indicator (CDI) was specified incorrectly, 
e.g., CDI=CD with ECI= IEC, or CDI=CD 
with EBI=EB. 


No-Response Not Allowed: No-response 
was specified on a request when not 
permitted. (Use only on EXR.) 


Chaining Not Supported: The chaining 
indicators (BCI and ECI) were specified 
incorrectly, e.g., chaining bits indicated 
other than (BC, EC), but multiple-request 
chains are not supported for the session or 
for the category specified in the request 
header. 


Brackets Not Supported: The bracket indi- 
cators (BBI and EBI) were specified 
incorrectly, e.g., a bracket indicator was 

set (BBI=BB or EBI=EB), but brackets 

are not used for the session. 


CD Not Supported: The change-direction 
indicator was set, but is not supported. 


Reserved. 
Incorrect Use of Format Indicator: The 
format indicator (Fl) was specified 


incorrectly, e.g., Fl was set with BCI= IBC, 
or Fl was not set on a DFC request. 
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Sense Codes 


Sense Code 
(Hex) 


4010 


4011 


4012 


4013 


4014 


4015 


4016 


4017 


192 


Meaning 


Alternate Code Not Supported: The code 
selection indicator (CSI) was set when not 
supported for the session. 


Incorrect Specification of RU Category: 
The RU category indicator was specified 
incorrectly, e.g., an expedited-flow request 
or response was specified with RU category 
indicator = FMD. 


Incorrect Specification of Request Code: 
The request code on a response does not 
match the request code on its corresponding 
request. 


Incorrect Specification of (SDI, RTI): The 
sense data included indicator (SD!) and the 
response type indicator (RTI) were not 
specified properly on a response. The 
proper value pairs are (SDI=SD, RTI= 
negative) and (SDI= 1SD, RT|=positive). 


Incorrect Use of (DR11, DR2!, ERI): The 
definite response 1 indicator (DR11), 
definite response 2 indicator (DR21), and 
exception response indicator (ERI) were 
specified incorrectly, e.g., a Cancel re- 
quest was not specified with DR1I=DR1, 
DR2I= IDR2, and ERI=ER. 


Incorrect Use of QRI: The queued response 
indicator (QRI) was specified incorrectly, 
e.g., QRI=QR on an expedited-flow request. 


Incorrect Use of EDI: The enciphered data 
indicator (EDI) was specified incorrectly, 
e.g., EDI=ED on a DFC request. 


Incorrect Use of PDI: The padded data 
indicator (PDI) was specified incorrectly, 
e.g., PDI=PD on a DFC request. 

















Sense Codes 
Path Error (Category Code Hex 80) 


This category indicates that the request could not be 
delivered to the intended receiver because of a path outage, 
an invalid sequence of activation requests, or one of the 
listed path information unit (PIU) errors. (Some PIU errors 
fall into other categories, e.g., sequence number errors are 
category hex 20.) A path error received while the session 

is active generally indicates that the path to the session 
partner has been lost. In this case, the NAU services 
manager receiving the -RSP (Path Error) may deactivate 

the affected half-session. 


Sense Code 

(Hex) Meaning 

8001 Intermediate Node Failure: Machine or 
program check in a node providing inter- 
mediate function. A response may not 
be possible. 

8002 Link Failure: Data link failure. 

8003 NAU Inoperative: The NAU is unable to 
process requests or responses, e.g., the 
NAU has been disrupted by an abnormal 
termination. 

8004 Unrecognized Destination Address: A 
node in the path has no routing informa- 
tion for the destination specified by the 
TH. 

8005 No Session: No half-session is active in 


the receiving end node for the indicated 
Origination-destination pair, or no 
boundary function half-session compo- 
nent is active for the origin-destination 
pair in a node providing the boundary 
function. A session-activation request 
is needed. 
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Sense Codes 


Sense Code 
(Hex) 


8006 


8007 


8008 


8009 


800A 


194 


Meaning 


Invalid FID: Invalid FID for the receiving 
node. It is generally not possible to send a 
response for this exception condition, since 
information (FID, addresses) required to 
generate a response is not available. It is 
logged as an error if this capability exists in 
the receiver. 


Segmenting Error: First BIU segment had 
less than 10 bytes; or mapping field 
sequencing error, such as first, last, middle; 
or segmenting not supported and MPF not 
set to 11. If segmenting is not supported, a 
negative response is returned for the first 
segment only,-since this contains the RH. 
Subsequent segments are discarded. 


PU Not Active: The SSCP-PU secondary 
half-session in the receiving node has not 
been activated and the request was not 
ACTPU for this half-session; for example, 
the request was ACTLU from an SSCP 
that does not have an active SSCP-PU 
session with the PU associated with the 
addressed LU. 


LU Not Active: The destination address 
specifies an LU for which the SSCP-LU 
secondary half-session has not been 
activated and the request was not ACTLU. 


Too-Long PIU: Transmission was 
truncated by a receiving node because the 
PIU exceeded a maximum length or 
sufficient buffering was not available. 








Sense Code 
(Hex) 


800B 


800C 


800D 


800E 


800F 


8010 


8011 


Sense Codes 


Meaning 


Incomplete TH: Transmission received 
was shorter than a TH. It is generally not 
possible to send a response for this excep- 
tion condition, since information (FID, 
addresses) required to generate a response 
is not available. It is logged as an error if 
this capability exists in the receiver. 


DCF Error: The data count field (DFC) 
is inconsistent with the transmission length. 


Lost Contact: Contact with the link station 
for which the transmission was intended has 
been lost, but the link has not failed. If the 
difference between link failure and loss of 
contact is not detectable, link failure 

(hex 8002) is sent. 


Unrecognized Origin: The origin address 
specified in the TH was not recognized. 


invalid Address Combination: The (DAF’, 
OAF’) (F1D2) combination or the LSID 
(FID3) specified an invalid type of session, 
e.g.,a PU-LU combination. 


Segmented RU Length Error: An RU was 
found to exceed a maximum length, or 
required buffer allocation that might cause 
future buffer depletion. 


ER Inoperative or Undefined: A PIU was 
received from a subarea node that does not 
support ER and VR protocols, and the 
explicit route to the destination is 
inoperative or undefined. 
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Sense Codes 


Sense Code 
(Hex) Meaning 





8012 Subarea PU Not Active or Invalid Virtual 
Route: A session-activation request for a 
peripheral PU or LU cannot be satisfied 
because there is no active SSCP-PU session 
for the subarea node providing boundary 
function support, or the virtual route for 
the specified SSCP-PU—T1|2 or SSCP-LU 
session is not the same as that used for the 
SSCP-PU session of the PU—T1|2’s or LU’s 
subarea PU. 





8013 COS Not Available: A session-activation 
request cannot be satisfied because none of 
the virtual routes requested for the session is 
available. This condition may arise because 
each of the specified virtual routes cannot 
be activated for one of the following reasons: 


e The specified virtual route cannot be 
mapped to an explicit route to the 
destination subarea, or the explicit route 
it is mapped to is not defined. 


e The underlying explicit route is not 
Operative. 


@ The underlying explicit route is opera- = r 
tive but cannot be activated. 


e The underlying explicit route is active 
but the virtual route cannot be 
activated. 


@ The session must be assigned to a virtual 
route with an underlying reverse explicit 
route number of O, but the virtual route 
does not meet this criterion. 
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Sense Codes 


Sense Code 
(Hex) 


8017 


Meaning 


PIU from Adjacent Pre-ER-VR Subarea 
Node Rejected: A PIU that requires 
intermediate path-control routing was 
received by a subarea node from an 
adjacent subarea node that does not 
support ER-VR protocols, but the re- 
ceiving subarea node does not support 
intermediate path-control routing for 
adjacent subarea nodes that do not 
support ER-VR protocols. 
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S6L 


Format 
Identification 


(FID) 


ao<c 70H OT 








0000=F IDO Segment - F |D@———e reserved 
0001=F ID1 ing @=normal |F1D1———reserved 
Q010=F ID2 Q@Q@=middle| flow F 1D2———e rr eser ved 
QQ@11=F 1D3 @l=last l=expedi- |F1D3———elocal session identification 
10=first ted (LSID) 
11=only f low Q@000 0000 = SSCP-PU session 
@1XX XXXX = SSCP-LU session 
1@XX XXXX = reserved 
11XX XXXX = LU-LU session 








€-O S3dAL Gl4 YOS SHFOQVSH NOISSIWSNVYL 


661 


( 


Os 






Destination 






Sequence 
Number 
Field 
( SNF ) 






FID3 is two bytes long 






N 


00 


oft} 2] 3] 4] 5] 6] 7] 8] ofte]ss| ra] is] ra] 15] 16] 17] 18] 19] 20]21 | 2223] 24] 25| 




















byte 2 
TG ER & VR) {VR Pacing 
@100| Sweep Support |Count 
Indicator] Indicator | Indicator 
FID4/Q=P1U may|@=Each @=VR Pac-|@=Flow is|R*=Reserved Initial jExplicit 
pass P{iUs|node sup-|ing Count} less than Explicit |Route 
1=PIU may/ports ER |not=@ network Route Number 
not pass |& VR 1=VR Pac-|priority Number 
PiUs = one ing count|1=Flow is 
does not |does = @ |Network 
Priority 
Abit|1 bit 1 bit 1 bit 1 bit 8 bits 4 bits 4 bits 





# 3dAL GI 4 YOS YIAVIH NOISSIWSNVYL 


LOZ 


[of s) 2) 3] 4} 5] 6] 7] 8] 9f vol raf vz} a5) 14) 15] 16) 17] 18] 19} 20] 21 }22]23] 26/25) 



























VR Se- 
quence & 
Type 

indicator 


VR Change|TG non- 
Window FIFO 
Indicator} Indicator 


Transmission Group 
Sequence 

Number 

Field 














Virtual @=Incre- |@=TG FIFO|@0=Non- | TGSNF 
Route Trans- ment Required |Sequenced 
Number mission |Window 1=TG FIFO}Non- 
Priority |Size Not Super - 
Q0=Low 1=Decre- |Required |visory 
@1=Medium|ment @1=Non- 
10=High |Window Seq, Super 
Size 11=Singly 
Sequenced 
4 bits 2 bits 1 bit 1 bit 2 bits 12 bits 


COZ 





PE ta Te end) 


ne 


DEEEGE 








byte 6 byte 7 bytes 8-11 


VR Pacing|VR Pacing|VR Change|VR Reset |VR Send |VR Send |Destination Subarea 
Request Response |Window Window Sequence {Sequence |Field 
(VRPRQ) (VRPRS) |Reply Indicator | Number Number (OSAF ) 

Indicator 





eserved/@=Do not |First Last 
0=In- Reset 4 bits 8 bits 
crement |Window of VRSSNFlof VRSSNF 
Window Size 


@=No VR @=No VR 
Pacing Pacing 
Response |Response 
Requested| 1=VR 


1=VR Pacing Size byl|1=Reset 
Pacing Response 1=De- [Window 
Response |Sent crement |Size to 
Requested Window Minimum 
Size byl 
1 bit 1 bit 1 bit 1 bit 4 bits 8 bits 4 bytes 





£02 
















in Subarea 
Field 
(OSAF ) 


Expedited 
F low 
Indicator 





Reserved 








Segment of BIU: @=Normal 
*Reserved| SNA O8=Middle F low 
Indicator] @1l=Last 1=Expe- 
@=Not SNA! 10=First dited 
1=SNA 11=Only F low 
4 bytes 3 bits 1 bit 2 bits 1 bit 1 bit 


v07c 





foe A] 2223 FR a] |] 8 Fa 9) 10] 2] a a8 se | |B] a8] 2a 22)23] 2h 










byte18-19|/byte20-21]byte22-23] byte24-25 


Destina- |Origin Sequence |Data 
tion Element {Number Count 
Element {Field Field Field 
Field 


1 byte 2 bytes 2 bytes 2 bytes 2 bytes 





GOZ 


( 


REDE OnO tmnt mmm lO aa ccinle 


| 


byte 0 byte 1 byte 2 byte 4 bytes 4-S|bytes 6-23 byte24-25 


Command Command Command 
Reserved |Format Type Sequence | Reserved 
Number 





de 
< 


*Reserved x'@1' x'o1'- 
kbit}4bit!8 bits 8 bits 8 bits 2 bytes 18 bytes 2 bytes 


“TG SNF Wrap Acknowledgment (only value defined) 


4d ddAl Q)4 YOd YAIAVIH NOISSIWSNVYL 


REQUEST/RESPONSE HEADER 





This information is taken from the Systems Network wes 
Architecture Format and Protocol Reference Manual: 
Architectural Logic (SC30-3112). 


The request or response header (RH), when present, 
follows the transmission header (TH). In a request 
it is a request header; in a response, a response 
header. In either case, the RH is three bytes long. 
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LOZ 


byte @ 


Q=re- 
quest 


@0=F MD 
@1=NC 
1Q=DFC 
11=SC 


RU 
Category 


byte 1 
r 
e 
Ss Format 
e Indicator 
; 
Vv (Fl) 
e 
d 





for LU-LU,1=FM 
header follows 
for SSCP ,@=charac- 
ter-coded RU 

1=f ield- 
formatted RU 
FI=1 (always) 


Sense 
Data 
Indicator 
(SDI) 


1=Sense 
Data 
included 
(EXR 
only) 


byte 2 


Indicator | Indicator 





Q0=mi ddl 

@l=last U 
1@=first in 
11=only chain 





W30V3H LS3NO3Y 


802 





byte @ byte 1 


Definite 
Response 
1 


Definite |Exception 
Response |Response 
Indicator 


Indicator 
(DR11) 


Indicator 
(DR21) (ERI) 


ane wound 





Q@QQ=No response requested 

010, 1000,1010=def inite response 
requested 

@11,1001,1011=exception response 
requested 


byte 2 


Queued Pacing 
Response | Indicator 
Indicator 


(QR1) (PI) 








@=response bypasses 1=pacing 
transmission control queues;request 
1=enqueue response in 
transmission control queues 





602 





r a 

e Enci- Condi 

s Select ion|phered tional 

e Indicator |Data Indicator |End 

r Indicator Bracket 
Vv (EDI) Pamicl? 

é ndicato 
d (CEBI) 


l=beqi 5 = - r 1=RU was |1=Condi- 
=begin | 1l=end l=change 1=RU is : 
bracket] bracket|direction @=code @ |Enci- padded} tional 
1=code 1 |phered before| end 
enciphy bracket 
erment 


OL~ 


byte @ byte 1 byte 2 


l=re- 
sponse 


. 
e Format Sense 
R U S Indicator |Data 
e Indicator 
Category r (Fl) (SDI) 
Vv 
e 
d 








l=sense |11=only RU in chain 
for LU-LU,for data 


1Q=DFC positive rsp,Fl=@ | included 
11=SC for SSCP ,@=charac-| (-RSP 
ter-coded RU only) 
l=field- 
formatted RU 
FI=1 (always) 





YSQVSH JSNOdSIY 


LL? 





byte @ 


Definite 
Response 
1 


Definite 
Response 
2 
Indicator 
(DR21) 


Indicator 
(DR11) 


Apt THM OM 


a eee 


Q@00=Reserved except in IPR 
(with RTI=0) 

10@=DRI response 

@01=DR2 response 

101=DR1 and DR2 response 

(DR2 used with sync point) 


byte 1 


Response 
Type 
indicator 


(RTI) 


@=+RSP 
=-RSP 





byte 2 


Queued Pacing 
Response | Indicator 
Indicator 


(QR!) (PI) 





l=pacing 
@=response bypasses TC queues|response 
1=enqueue response in 

TC queues 









@ 924q 
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